Running apps on Linux

Unlike Windows and macOS it can sometimes be tricky for non-Linux users to ensure that Linux is properly configured to run Xojo apps.

Below are some tips to help you get your Xojo apps running on Linux.

Start with a supported version of Linux

Refer to the System Requirements to see which Linux distributions are supported. Unless you are a Linux expert you should stick with one of the supported distributions. Although other distributions definitely work, they may require significant configuration and installation of libraries and other things.

The most common library that needs installation is libunwind8.

Required Linux Libraries

32-bit or 64-bit?

Is your Linux distribution 64-bit or 32-bit? Did you build your app as 32-bit or 64-bit? For best results you should build 32-bit apps for 32-bit Linux distributions and 64-bit apps for 64-bit Linux distributions. It is possible to get 32-bit apps to run on 64-bit versions of Linux but you again may need to install additional libraries (as noted in System Requirements).

Start from the terminal

If your app does not start or seems like it might be crashing, try start it from the Terminal even if it is not a Console app. On Linux the Terminal will display additional information and errors that may help with troubleshooting.

To start an app from the Terminal, go to its folder and prefix the app name with "./":


If there are spaces in the name you'll have to use quotes or escape them:

./"My App"
./My\\ App"

Handle Exceptions

If your app has unhandled exceptions, fix their causes. For example, files on Linux are often in different locations than you'll expect on Windows or Mac. So you should make use of SpecialFolder, #If...#Endif, etc.