System requirements

These are the system requirements for the current shipping release of Xojo.

Xojo IDE

OS

Requirements

macOS

10.14 (Mojave) - 15 (Sequoia)

Windows

10 (build 1903+) - 11

Linux

Mint 20 or later, Ubuntu20.04 or later, Or any Linux distro with GTK 3.22, glibc 2.27 and libstdc++.so.6.0.21 or better.

Tip

An SSD is recommended for best performance.

Note

When using the Xojo IDE on Windows running on a virtual machine, you may experience drawing performance issues. Refer to the Virtual Machines topic for suggestions on how to optimize your VM.

Note

When using the Xojo IDE on Linux, Linux Mint 18.3 or later is highly recommended. See the Linux Notes for more specific library information. The Xojo IDE itself is not currently supported for Linux on ARM.

Desktop apps

Desktop apps built with Xojo will run on any computer that meets the following requirements.

OS

Requirements

macOS

10.14 (Mojave) - 15 (Sequoia)

Windows

10 (build 1903+) - 11

Linux

Linux Mint 20 or later, CentOS 7.0 or later, Ubuntu 20.04 LTS or later, Debian 6.0 or later, OpenSUSE 11.3 or later, Fedora 13 Desktop or later

Raspberry Pi

Pi 2 or later running Raspberry Pi OS 11 (Bullseye)

Note

For best results, build 64-bit apps for users running on 64-bit processors.

Note

Windows apps must have the Visual C++ Redistributable included in the installer or have the DLLs included with the app. More information available in the Windows Universal Runtime topic.

Note

The libunwind8 library is required to run apps on Raspberry Pi.

Warning

Apps may run on other configurations but are not officially supported.

Android apps

In order to work on Android projects, you must have:

Type

Information

Android Studio versions

2022.2.1 or later

Android versions

8 (SDK 26) or later

Note

A Google Play Store Developer account is required to publish apps to the Google Play Store.

iOS apps

In order to work on iOS projects, you must have:

Type

Information

A Mac with Xcode

Current Version

iOS versions

14 - 18

Note

An iOS Developer Subscription from Apple is required to use Apple's Test Flight, for deploying to devices and for submitting apps to Apple's App Store.

Note

Debugging on the device itself requires it to have iOS 17.0+ installed.

Web apps

Browser requirements

OS

Requirements

macOS

Safari, Chrome, Firefox

Windows

Chrome, Firefox, Edge

Linux

Chrome, Firefox

Raspberry Pi

Raspbian Epiphany Web Browser, Chromium

iOS

Safari

Android

Chrome

Note

The latest supported versions of these browsers are recommended and in some cases may be required.

Server requirements

OS

Requirements

macOS

10.14 (Mojave) - 15 (Sequoia)

Windows

10 (build 1903+) - 11, Windows Server 2012 - 2016

Linux

Linux Mint 20 or later, CentOS 7.0 or later, Ubuntu 20.04 LTS or later, Debian 6.0 or later, OpenSUSE 11.3 or later, Fedora 13 or later

Raspberry Pi

Pi 2 or later running Raspberry Pi OS 11 (Bullseye)

Note

Web apps running on a server running Windows must have the Visual C++ Redistributable included in the installer or have the DLLs included with the app. More information available in the Windows Universal Runtime topic.

Console apps

Console apps do not have a user interface and have the same requirements listed for Web Server Requirements in the above section.

Linux notes

Library information

Because various Linux distributions have different libraries installed by default, you may need to install additional libraries before your Xojo apps will run on Linux. At a minimum, Xojo requires these Linux libraries:

  • glib 2.0

  • glib 2.64.6 (ARM 64-bit)

  • libstdc++.so.6.0.13

  • libunwind8

  • GTK+ 3 (3.4.1 minimum)

  • GTK 3.24.20 (desktop apps on ARM 64-bit)

  • libwebkit2gtk - used by DesktopHTMLViewer and thus the Documentation window and Messages panel

  • libsoup 2.4 - used by URLConnection

  • Pango - used by PDFDocument

If you're looking for a specific version and distribution, check out mirrors.kernel.org.

Note

If libwebkit2gtk is not installed, libwebkitgtk-3.0-0 will be used.

Installing tar on Fedora KDE Plasma Spin

Some Linux distributions, such as Fedora, have a KDE Plasma option that is popular with users. If you want to run Xojo on Fedora's KDE Plasma Spin, here are some steps that may help.

Download the Xojo TGZ package to your Downloads folder and do this in a Terminal:

sudo -s
yum -y install gtk3 gtk3-devel libunwind
cd /opt
mkdir xojo
cd xojo
tar -zxvf ~/Downloads/xojo2018r4.tgz

To have a desktop entry for Xojo appear in the system menu you can create a ".desktop" file and place it in /usr/share/applications/. This is what the file looks like for 2018r4:

[Desktop Entry]
Encoding=UTF-8
Name=Xojo 2018r4
Name[en_GB]=Xojo 2018r4
Comment=Xojo 2018 Release 4
Comment[en_GB]=Xojo 2018 Release 4
Exec=/opt/xojo/xojo2018r4/Xojo %F
Icon=/opt/xojo/xojo2018r4/appicon_128.png
Terminal=false
Type=Application
MimeType=application/vnd.xojo.project.binary;application/vnd.xojo.project.normal;application/vnd.xojo.project.xml
Categories=Development;Programming;Building;IDE

You will need to use sudo to add any plugins to the resulting install in /opt/xojo/xojo2018/Plugins.

Wayland

Xojo relies on X11 for the display server. Xojo technically supports Wayland currently, but there may still be issues that are not present when using X11. Wayland will be fully supported in a future version. In the meantime, if you want to run your app in Wayland, do the following:

  • Find the 'Exec' line in /usr/share/applications/xojo2024r11.desktop

  • Add 'env -u WAYLAND_DISPLAY GDK_BACKEND=x11' to the line

A number of distros, including Ubuntu and Fedora, default to Wayland, with Fedora planning to remove X11 for some of its versions, such as the Gnome and KDE Plasam spins. If your distro does not have X11 support installed you might be able to manually install from the Terminal:

apt install xserver-xorg-core

64-bit configuration for running 32-bit apps

32-bit libraries are not usually installed by default on 64-bit Linux distributions. The commands below can be used with some common Linux distributions to get the appropriate 32-bit libraries installed so that 32-bit apps run.

OS

Library Installation Notes

Linux Mint 18 (recommended)

Mint includes most of the necessary libraries. You'll need to install 32-bit GTK+ 3 and webkit with this command:

sudo apt-get install libgtk-3-0:i386 libwebkitgtk-3.0-0:i386

Ubuntu 16+

This installs the necessary GTK+ 3 and other necessary 32-bit libraries:

sudo dpkg --add-architecture i386
sudo apt-get update

sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 libglib2.0-0:i386 libsoup2.4-1:i386 libgtk-3-0:i386 libwebkitgtk-3.0-0:i386

openSUSE Leap 42.2+

Start the YaST tool (select Software Management) and manually search for and install these libraries:

libgtk-3-0-32bit
libwebkitgtk-3_0-0-32bit

Fedora 25+

This installs the necessary 32-bit libraries:

sudo yum install glib2.i686 libgcc.i686 libstdc++.i686 gtk3.i686 webkitgtk3.i686

CentOS 7

This installs the necessary 32-bit libraries:

sudo yum install glib2.i686 libgcc.i686 libstdc++.i686 gtk3.i686 webkitgtk3.i686

For best results build 64-bit Xojo apps for distribution on 64-bit Linux systems.

If you are still having trouble identifying necessary libraries, the ldd command might help. You can run this command from Terminal in the Xojo directory to return a list of libraries required by Xojo and their status on the system:

ldd Xojo

International components for unicode (libicu)

Linux apps made with Xojo 2016 Release 3 or later include the libicu libraries as part of the app package (in the Libs folder). You do not need to install libicu separately. Refer to System Requirements for older versions if you need help with this.

Pi notes

Raspberry Pi OS (formally Raspbian) needs the libunwind8 library to be installed, which you can do from the Terminal with this command:

sudo apt-get install libunwind8

You may need to update WebKit if you use HTMLViewer using a command like this:

sudo apt-get install libwebkit2gtk

Note

libwebkitgtk-3.0 will be used if libwebkit2gtk is not installed.

In addition it is always good to keep your Pi up to date with these Terminal commands:

sudo apt-get update
sudo apt-get dist-upgrade

CPU notes

x86 CPUs require the SSE2 instruction set for the IDE and built applications. The vast majority of desktop CPUs in use support this, but some x86 single board computers may not.

To run on Linux on 32-bit ARM CPUs, the CPU must support the ARMv7 architecture.

Linux on Chromebooks

Chromebooks are a popular option for running various Linux distros. Unfortunately, due to limitations with the hardware, Xojo is not officially supported on the Chromebook. You may be able to get it working, but it will require some tweaking and is not supported.