Acumatica Linux

After looking at the Acumatica 3rd party / licence doc, there seems to be a lot of Windows specific dependencie. I hope thay are included in DLL form as part of the distribution.

My interest is getting a runtime version of Acumatica working on Linux / Mono. Development should be done in the Acumatica Windows Developer Studio. (Current Windows product)

If Acumatica is more than Mono can handle, I still feel I achieved something. Having a .NET / C# and ASP that works with Apache to add to my 🍊 Pi Zero portable Linux server image is a plus.

All software on the 🍊 Pi Zero is open source and free.

This is an overview of system resources being used on on the Orange Pi Zero. This includes Ubuntu server, Webmin, Apache, MySQl, Postgress SQL, Mono and Acumatica installed in /Acumatica_demo of the Apache webroot.

orangepi@zero-dev:/var/www/html/Acumatica_demo$ df -h
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           394M  5.9M  388M   2% /run
/dev/mmcblk0p1  465G   12G  448G   3% /
tmpfs           2.0G  1.2M  2.0G   1% /dev/shm
tmpfs           5.0M   16K  5.0M   1% /run/lock
tmpfs           2.0G     0  2.0G   0% /tmp
/dev/zram1       47M   19M   25M  44% /var/log
tmpfs           394M  4.0K  394M   1% /run/user/1000
orangepi@zero-dev:/var/www/html/Acumatica_demo$ free -h
               total        used        free      shared  buff/cache   available
Mem:           3.8Gi       619Mi       1.2Gi        20Mi       2.2Gi       3.2Gi
Swap:          1.9Gi          0B       1.9Gi
orangepi@zero-dev:/var/www/html/Acumatica_demo$

I made all the changes to Web.config pointing to where they are located on the Linux server. I’m getting this error pointing to a Windows path I thought I fixed with the following line change. There must be another configuration file getting a Windows path for this.

    <compilation debug="True" defaultLanguage="c#" numRecompilesBeforeAppRestart="9999" targetFramework="4.8" batch="True" optimizeCompilations="False" tempDirectory="/home/orangepi/Acumatica_ERP/TemporaryAspFiles/Acumatica_demo">

Restarting Apache got me by the previous error after uploading the new Web.config file.

I have no idea what this error is telling me. Invalid Image? 

I don’t have these directories in my Acumatica_ERP on Linux. There were no reference to them in the Web.config file.My thought was these directories / files are used to build a new tenant. Is there another configuration file Acumatica uses besides Web.config?

This is a guess. Is it possible that the Linux version is trying to read the TemporaryAsp Files that were created on Windows and choking on them? Is it safe to clear those sub-directories in TemporaryAspFiles and let Mono rebuild them?

Another idea is the Web.config file is specifying an image type / ext that Mono doesn't understand. Shooting at stars here. 

My guess is Mono was creating the login page but failed loading an image. It seems Mono got pretty far down the road. 

I would like to make this a community effort as a step towards where Acumatica is eventually going.

Hopefully there is an image directory out of Acumatica ERP that I'm not referencing due to a custom Web.config like file.

Looking closer at the stack trace, the ‘image’ may be referring to an assembly image. I’m not a C# or ASP.NET programmer so any help or suggestions would be appreciated.

I hope this is a configuration issue and not a Mono issue.

Can the TemporaryAspFiles directory be cleared and Acumatica regenerate them on startup?

I think my problem is Mono is trying to load a Windows DLL or C# assembly that should be rebuilt by Mono.

​@JSpikowski Acumatica on Linux is not supported and will not be for a long time yet.

Acumatica heavily relies on .NET Framework and ASP.NET Webforms which do not run natively/well on Linux. Until Acumatica completes the re-write to .NET Core(which is in progress), you will be running a configuration that is completely unsupported by Acumatica and frequently broken.

If you are doing any dev for commercial work, I recommend that you switch to Windows for the time being and forget Linux efforts until Acumatica officially supports it. I like working on Linux and this looks like a fun exercise, but you won’t find any help from this community on this effort until Acumatica starts officially releasing versions that offer some support for Linux, because we have to work on something that is supported.

Windows Server has a 180 trial period and can be re-armed 3 times for free, giving you 1.5 years of usage before you have to reinstall.

My goal with Mono is to see if Acumatica is able to run on Linux. Plesk fully supports .NET Core on Linux but it is more resource intensive than Mono.

I don't see Acumatica having a Linux solution for at least a year or two. This doesn't seem to a priority for them.

I have Acumatica running on my Windows 10 laptop and on a AWS Windows 2025 Server Datacenter instance.

Thanks for your feedback.

I understand your goal, my point is that I’m afraid you’re wasting your time because even if you “kind of” get it to work, you will have something on your hands that you can’t do anything with whether developing on it or selling anything based on it, because it’s unsupported.

Side note: Modern UI is the future for running it on Linux when that time comes.

ASP is a dying platform which is a big problem for Acumatica as it is its core technology. 

The Modern UI eliminates most of the ASP generated form creation and only relies on ASP for callbacks. This will eventually be replaced with AJAX.

My efforts are trying to create a 'runtime' version of Acumatica using rendered HTML, Javascript and CSS.  

Development / enhancements are best done under Windows which the product was designed for.

How I view a Windows programmer.

Bottom line is Acumatica could care less where your Acumatica instance is running. On their SaaS offering, self hosted or on premises. The price is the same for the software.

I recommend having possession and full access to your DB for reliable backups and front-end external interfaces.

I cleared my TemporaryAspFiles directory. This is how far it got on the rebuild before the above ‘image’ not found exception occurred.

orangepi@zero-dev:~/Acumatica_ERP/TemporaryAspFiles/Acumatica_demo$ ls -l
total 80
drwxrwxr-x 2 orangepi orangepi  4096 Sep 17 11:36 acumatica_demo
-rw------- 1 orangepi orangepi 17311 Sep 17 11:37 App_Web_fwnnz0gm_10.cs
-rw------- 1 orangepi orangepi   575 Sep 17 11:37 App_Web_fwnnz0gm_1.cs
-rw------- 1 orangepi orangepi  9409 Sep 17 11:37 App_Web_fwnnz0gm_2.cs
-rw------- 1 orangepi orangepi  2088 Sep 17 11:37 App_Web_fwnnz0gm_3.cs
-rw------- 1 orangepi orangepi  4034 Sep 17 11:37 App_Web_fwnnz0gm_4.cs
-rw------- 1 orangepi orangepi  2788 Sep 17 11:37 App_Web_fwnnz0gm_5.cs
-rw------- 1 orangepi orangepi  2787 Sep 17 11:37 App_Web_fwnnz0gm_6.cs
-rw------- 1 orangepi orangepi  6129 Sep 17 11:37 App_Web_fwnnz0gm_7.cs
-rw------- 1 orangepi orangepi  6536 Sep 17 11:37 App_Web_fwnnz0gm_8.cs
-rw------- 1 orangepi orangepi  4205 Sep 17 11:37 App_Web_fwnnz0gm_9.cs
-rw------- 1 orangepi orangepi     0 Sep 17 11:37 fwnnz0gm.tmp
orangepi@zero-dev:~/Acumatica_ERP/TemporaryAspFiles/Acumatica_demo$

I checked my Windows version of what I’m porting to Linux / Mono and it’s trying to create temporary .cs files that don’t exist under Windows. 

I did notice a few monoxxx.dll references in the Windows code. Maybe this has been done before and a Web.config entry needs to be made?

I feel I hit the wall with this effort unless someone has a suggestion / solution.

-rw------- 1 orangepi orangepi 17311 Sep 17 11:37 App_Web_fwnnz0gm_10.cs
-rw------- 1 orangepi orangepi   575 Sep 17 11:37 App_Web_fwnnz0gm_1.cs
-rw------- 1 orangepi orangepi  9409 Sep 17 11:37 App_Web_fwnnz0gm_2.cs
-rw------- 1 orangepi orangepi  2088 Sep 17 11:37 App_Web_fwnnz0gm_3.cs
-rw------- 1 orangepi orangepi  4034 Sep 17 11:37 App_Web_fwnnz0gm_4.cs
-rw------- 1 orangepi orangepi  2788 Sep 17 11:37 App_Web_fwnnz0gm_5.cs
-rw------- 1 orangepi orangepi  2787 Sep 17 11:37 App_Web_fwnnz0gm_6.cs
-rw------- 1 orangepi orangepi  6129 Sep 17 11:37 App_Web_fwnnz0gm_7.cs
-rw------- 1 orangepi orangepi  6536 Sep 17 11:37 App_Web_fwnnz0gm_8.cs
-rw------- 1 orangepi orangepi  4205 Sep 17 11:37 App_Web_fwnnz0gm_9.cs
-rw------- 1 orangepi orangepi     0 Sep 17 11:37 fwnnz0gm.tmp

What Google says about this.

No, Acumatica does not run on Mono and currently requires Windows Server. The platform is a .NET application that relies on Microsoft's Internet Information Services (IIS), which is a Windows-specific web server. 

While a community member attempted to run Acumatica on Linux using Mono and Apache in 2025, they noted that the effort was complex due to many Windows-specific dependencies and was not a standard or supported configuration. 

Future direction

Although Acumatica's current server-side architecture is tied to the Microsoft stack, the company has indicated a future move towards cross-platform compatibility:

• Linux support: In 2025, an Acumatica moderator confirmed that the company is exploring running on Linux in the future, likely using .NET Core.
• .NET Core: The Acumatica platform is leveraging .NET Core and ASP.NET Core to support open-source and cross-platform applications. However, this is for building new cross-platform applications and may not apply to the existing legacy platform.
• Development environment: While developers can use cross-platform IDEs like Rider to build customizations, running the full Acumatica application server still requires the standard Windows environment. 

At this point, what I have working would allow ASP.NET based programs to run on a Clouds-R.Us sub-domain as a front-end external interface language rather than using ScriptBasic.

I have a rendered AR303000 (Customer Maintenace) .aspx file I put in webroot of my Windows IIS server and it worked. Menu navigation produce an error as expected.

I may try to get this aspx / cs screen running under Linux to see if Mono can support it. I think Acumatica is hard coded to run on IIS at this point.

I tried running http://10.0.0.53/Acumatica_demo/Frames/Login,aspx but got the same bad image exception I have been getting all along. 

It seemed to get a little farther trying to run the Login.aspx script. Something ablout the 11th iteration of the set fails.

orangepi@zero-dev:~/Acumatica_ERP/TemporaryAspFiles/Acumatica_demo$ ls -l
total 156
drwxrwxr-x 2 orangepi orangepi  4096 Sep 17 11:36 acumatica_demo
-rw------- 1 orangepi orangepi 17311 Sep 17 13:08 App_Web_bib28sqn_10.cs
-rw------- 1 orangepi orangepi   575 Sep 17 13:08 App_Web_bib28sqn_1.cs
-rw------- 1 orangepi orangepi  9409 Sep 17 13:08 App_Web_bib28sqn_2.cs
-rw------- 1 orangepi orangepi  2088 Sep 17 13:08 App_Web_bib28sqn_3.cs
-rw------- 1 orangepi orangepi  4034 Sep 17 13:08 App_Web_bib28sqn_4.cs
-rw------- 1 orangepi orangepi  2788 Sep 17 13:08 App_Web_bib28sqn_5.cs
-rw------- 1 orangepi orangepi  2787 Sep 17 13:08 App_Web_bib28sqn_6.cs
-rw------- 1 orangepi orangepi  6129 Sep 17 13:08 App_Web_bib28sqn_7.cs
-rw------- 1 orangepi orangepi  6536 Sep 17 13:08 App_Web_bib28sqn_8.cs
-rw------- 1 orangepi orangepi  4205 Sep 17 13:08 App_Web_bib28sqn_9.cs
-rw------- 1 orangepi orangepi 17311 Sep 17 11:37 App_Web_fwnnz0gm_10.cs
-rw------- 1 orangepi orangepi   575 Sep 17 11:37 App_Web_fwnnz0gm_1.cs
-rw------- 1 orangepi orangepi  9409 Sep 17 11:37 App_Web_fwnnz0gm_2.cs
-rw------- 1 orangepi orangepi  2088 Sep 17 11:37 App_Web_fwnnz0gm_3.cs
-rw------- 1 orangepi orangepi  4034 Sep 17 11:37 App_Web_fwnnz0gm_4.cs
-rw------- 1 orangepi orangepi  2788 Sep 17 11:37 App_Web_fwnnz0gm_5.cs
-rw------- 1 orangepi orangepi  2787 Sep 17 11:37 App_Web_fwnnz0gm_6.cs
-rw------- 1 orangepi orangepi  6129 Sep 17 11:37 App_Web_fwnnz0gm_7.cs
-rw------- 1 orangepi orangepi  6536 Sep 17 11:37 App_Web_fwnnz0gm_8.cs
-rw------- 1 orangepi orangepi  4205 Sep 17 11:37 App_Web_fwnnz0gm_9.cs
-rw------- 1 orangepi orangepi     0 Sep 17 13:08 bib28sqn.tmp
-rw------- 1 orangepi orangepi     0 Sep 17 11:37 fwnnz0gm.tmp
orangepi@zero-dev:~/Acumatica_ERP/TemporaryAspFiles/Acumatica_demo$

Here is the last .cs page Mono created running the Login.aspx page.

App_Web_bib28sqn_10.cs

The next _11.cs file seems to be failing loading the page. Here is a Windows version of a _11.cs file.

#pragma checksum "C:\Program Files\Acumatica ERP\Acumatica_demo\Pages\EP\EP303010.aspx.cs" "{ff1816ec-aa5e-4d10-87f7-6f4963833460}" "29C3AA16AE4205C4181954C7411587A44393976E"

#line 1 "C:\Program Files\Acumatica ERP\Acumatica_demo\Pages\EP\EP303010.aspx.cs"
using System;

public partial class Page_EP303010 : PX.Web.UI.PXPage
{
    protected void Page_Init(object sender, EventArgs e)
    {
	}
}


#line default
#line hidden

I'm wondering if my issue is that my files in TemporaryAspFiles are only read / write and I need to add execute permissions. It looks like this might be my problem.

Yes, the primary Mono runtime executable (mono or mono-sgen) needs execute permissions to function as a .NET runtime, and your compiled .NET applications (.exe or .dll) also need execute permission to be run by the Mono runtime. The Mono installation process on Linux typically sets these permissions, but you might need to ensure your application files are also executable using chmod +x. 

Permissions for the Mono Runtime:

1. Mono Runtime: 

   The mono executable itself, located in /usr/bin/mono or similar, needs execute permissions to be run. 

2. Installation: 

   When you install Mono using a package manager (like apt or dnf) or by compiling from source, the installer usually sets the necessary permissions for the runtime files. 

Permissions for your .NET Applications:

1. Compiled Binaries: 

   When you compile a .NET application on Linux using Mono's mcs compiler, the resulting executable (.exe or .dll) often receives the execute permission. 

2. Manual Execution: 

   If the execute permission is missing on your application, you can add it by using the chmod +x <your_app.exe> command in the terminal. 

3. Example: 

   If you have an application named MyAwesomeApp.exe, you would make it executable with this command:

Code

    chmod +x MyAwesomeApp.exe

1. Running the Application: Once you have the correct permissions, you can run it directly: 

Code

    ./MyAwesomeApp.exe

Or, if it's not directly executable, you can still run it through the Mono runtime: 

Code

    mono MyAwesomeApp.exe