System requirements for current release
These are the system requirements for the current shipping release of Xojo.
Xojo IDE
OS |
Requirements |
|---|---|
Windows |
The Xojo IDE is 64-bit so it only runs on 64-bit versions of Windows. You can continue to build 32-bit apps as necessary. Microsoft regularly fixes bugs as part of Windows Update so be sure to always have the latest updates applied to your system. An SSD is recommended for best performance. There may be drawing performance issues when editing web layouts when running Xojo in a Virtual Machine. Refer to the Virtual Machines topic for suggestions on how to optimize your VM. |
macOS |
macOS Mojave (10.14) or higher is required to build for Apple silicon. See below for iOS requirements. An SSD is recommended for best performance. |
Linux |
Linux Mint 18.3+ Cinnamon is suggested. Refer to Linux Notes for more specific library requirements. The Xojo IDE is 64-bit so it only runs on 64-bit versions of Linux. You can continue to build 32-bit apps as necessary, but you will need to install 32-bit libraries to run and test 32-bit apps on a 64-bit version of Linux. An SSD is recommended for best performance. The Xojo IDE does not run on Linux for ARM. |
Desktop apps
Desktop apps built with the Xojo programming language and IDE will run on any computer that meets the following requirements.
OS |
Requirements |
|---|---|
Windows |
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. |
macOS |
|
Linux |
32-bit and 64-bit versions of Linux are supported.
For best results on 64-bit distributions, build a 64-bit app. |
Raspberry Pi |
Pi 2, 3 and 4 running:
Other single-board computers that are compatible with a 32-bit or 64-bit ARMv7 CPU may also work, but are not officially supported. Raspberry Pi OS (formally Raspbian) is the only supported OS. |
Warning
Xojo only supports the above listed operating system versions. Your apps may still run on earlier versions but that is unsupported.
Web apps
Browser requirements
OS |
Requirements |
|---|---|
Windows |
|
macOS |
|
Linux |
|
Raspberry Pi |
|
iOS |
|
Android |
|
Server requirements
OS |
Requirements |
|---|---|
Windows |
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. |
macOS |
|
Linux |
|
Raspberry Pi |
Pi 2, 3, 4 running:
Raspberry Pi OS (formally Raspbian) is the only supported OS. |
Console apps
Console apps do not have a user interface and have the same requirements listed for Web Server Requirements in the above section.
iOS apps
In order to work on iOS projects, you must be using Xojo on at least macOS 10.14 and later with Xcode 11 and later (required for iOS Simulator).
Type |
Information |
|---|---|
Supported macOS versions |
|
Supported Xcode versions |
|
Supported iOS versions |
|
Supported iOS devices |
|
iOS Developer Subscription required for |
|
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)
glibc-2.11 (32-bit)
glibc-2.14 (64-bit)
glibc-2.31 (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, 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/CentOS/SuSE
Fedora, CentOS, or a SuSe/OpenSuSE variant all default to a KDE/QT environment. If you want to run Xojo on those distributions, 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 uses X11 as its backend to GTK+. Wayland will be supported in a future version. If your distro does not have X11 support installed you might be able to manually install from the Terminal:
apt-get 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.