Xojo Documentation Xojo Documentation

<a id="Xojo IDE" name="Xojo IDE">Xojo IDE</a>

The Xojo IDE can be used on systems that meet the following requirements:

<thead> </thead> <tbody> </tbody>

	Windows 64-bit	macOS	Linux 64-bit
OS	Windows 10 64-bit Windows 8.1 64-bit Windows 7 SP1 Platform Update 64-bit 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.	macOS High Sierra 10.13.x macOS Sierra 10.12.x OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.51 <a href="#iOS Apps">See below</a> for iOS requirements. 1 OS X 10.9.5 support is <a hqid="291564" href="#">deprecated</a>.	Linux Mint 16 or later (18.3 Cinnamon suggested) Ubuntu 12.04 or later (16 suggested) CentOS 7 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later Linux Mint 18.3 Cinnamon is suggested. 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. The 64-bit IDE still needs 32-bit libraries, so refer to <a href="#64-bit Configuration">64-bit Configuration</a> for information on how install 32-bit libraries on 64-bit Linux distributions. The Xojo IDE does not run on Linux for ARM.
RAM	Minimum 2GB	Minimum 2GB	Minimum 2GB
Other	PDF viewer for documentation		PDF viewer for documentation

<a id="Desktop Apps" name="Desktop Apps">Desktop Apps</a>

Desktop apps created with Xojo have these requirements:

<thead> </thead> <tbody> </tbody>

	Windows	macOS	Linux (x86, x86-64)	Raspberry Pi
OS	32-bit and 64-bit versions of Windows are supported. Windows 10 Windows 8.1 Windows 7 SP1	macOS High Sierra 10.13.x macOS Sierra 10.12.x OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.51 1 OS X 10.9.5 support is <a hqid="291564" href="#">deprecated</a>.	32-bit and 64-bit versions of Linux are supported. Linux Mint 16 or later CentOS 7.0 or later Ubuntu 12.04 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later For best results on 64-bit distributions, build a 64-bit app.	Pi 2 and Pi 3 running: Raspbian Wheezy Raspbian Jessie Raspbian Jessie with Pixel Raspbian Stretch Other single-board computers that are compatible with the 32-bit ARMv7 CPU may also work.

<a id="Web Apps" name="Web Apps">Web Apps</a>

Web apps consist of two parts: user interface displayed in the web browser and the app itself.

<a id="Web Browser" name="Web Browser">Web Browser</a>

Your users can use a web app in one of the following browsers for these platforms:

<thead> </thead> <tbody> </tbody>

	Windows	macOS / macOS Server	Linux	iOS	Android	Raspberry Pi
Browser	Chrome 37+ Firefox 17+ Edge Internet Explorer 10+ SSL requires 11+ or <a href="#SSL">settings change for 10+</a>	Safari 6.0+ SSL requires 7.0+ Chrome 37+ Firefox 17+	Chrome 37+ Firefox 17+	Mobile Safari	Chrome for Android	Raspbian Epiphany Web Browser Chromium for Raspbian Pixel

<a id="Security" name="Security">Security</a>

For <a id="SSL" name="SSL">SSL</a> with IE 10, you may need manually enable TLSv12 with these steps:

1. Select "Tools" ↠ "Internet Options". Depending on your IE settings, the "Tools" menu may be a gear icon in the upper right hand corner.
2. Go to the "Advanced" tab. 
3. Scroll down to the "Security" section. 
4. Locate and check "Use TLS 1.2" in the Security section.
5. Then, press the "OK" button.

You may need to close and reopen all open browser windows in order for these new settings to take effect.

<a href="http://blog.xojo.com/microsoft-is-killing-internet-explorer-8-9-and-10" target="_blank">Microsoft no longer supplies security updates to IE 10 for most users</a>, so you may want to consider upgrading to IE 11 or using a different browser.

<a id="Web Server" name="Web Server">Web Server / Deployment</a>

Web apps can be deployed to servers with these requirements:

<thead> </thead> <tbody> </tbody>

	Windows	macOS / macOS Server	Linux (x86, x86-64)	Raspberry Pi
OS	32-bit and 64-bit servers are supported. Windows Server 2016 Windows Server 2012 Windows Server 2008 R2 Windows 10 Windows 8.1 Windows 7	macOS High Sierra 10.13.x macOS Sierra 10.12.x OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.51 1 OS X 10.9.5 support is <a hqid="291564" href="#">deprecated</a>.	32-bit and 64-bit servers are supported.  Linux Mint 16 or later Ubuntu 12.04 or later CentOS 7.0 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 or later	Pi 2 and Pi 3 running: Raspbian Wheezy Raspbian Jessie Raspbian Jessie with Pixel Raspbian Stretch Other single-board computers that are compatible with the 32-bit ARMv7 CPU may also work.
Deployment	<a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a> <a hqid="301710" href="#">IIS</a>	<a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a>	<a hqid="298523" href="#Xojo Cloud">Xojo Cloud</a> <a hqid="298523" href="#Stand-alone Application">Standalone</a> <a hqid="298523" href="#Apache">Apache 2</a>	<a hqid="298523" href="#Stand-alone Application">Standalone</a>

<a id="Console Apps" name="Console Apps">Console Apps</a>

Console apps do not have a user interface and run on systems with these requirements (or any of the server requirements listed for Web Apps):

<thead> </thead> <tbody> </tbody>

	Windows	macOS / macOS Server	Linux (x86, x86-64)	Raspberry Pi
OS	Windows 10 Windows 8.1 Windows 7	macOS High Sierra 10.13.x macOS Sierra 10.12.x OS X El Capitan 10.11.x OS X Yosemite 10.10.5 OS X Mavericks 10.9.51 1 OS X 10.9.5 support is <a hqid="291564" href="#">deprecated</a>	Linux Mint 16 or later Ubuntu 12.04 or later CentOS 7.0 or later Debian 6.0 or later OpenSUSE 11.3 or later Fedora 13 Desktop or later	Pi 2 and Pi 3 running: Raspbian Wheezy Raspbian Jessie Raspbian Jessie with Pixel Raspbian Stretch Other single-board computers that are compatible with the 32-bit ARMv7 CPU may also work.

CPU Compatibility

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.

ARM CPUs must support the 32-bit ARMv7 architecture.

<a id="iOS Apps" name="iOS Apps">iOS Apps</a>

In order to work on iOS projects, you must be using Xojo on at least macOS 10.11 and later with either Xcode 8.x or 9.x (required for iOS Simulator).

<tbody> </tbody>

Supported macOS versions	10.13 10.12 10.11
Required Xcode versions	9.x (recommended) 8.x
Supported iOS Versions	iOS 11 iOS 10
Supported iOS Devices	Any 64-bit iOS devices that work with the supported iOS versions iPhone 5S+, iPad Air+, iPad mini 2+, iPod Touch 6th gen+
iOS Developer Subscription Requirements	Deploying to iOS devices Submitting to App Store Test Flight

<a id="Linux Information" name="Linux Information">Linux Information</a>

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:

<thead> </thead> <tbody> </tbody>

Always Required	Required for Desktop	Optional
glib 2.0 glibc-2.11 (32-bit) glibc-2.14 (64-bit) libstdc++.so.6.0.13	GTK+ 3 (3.4.1 minimum)	libsoup 2.4 (<a hqid="208551" href="#">Xojo.Net.HTTPSocket</a>)  libwebkitgtk-3.0-0 (HTMLViewer)

If you're looking for a specific version and distribution, check out <a href="http://mirrors.kernel.org" target="_blank">mirrors.kernel.org</a>.

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

<a id="64-bit Configuration" name="64-bit Configuration">64-bit Configuration</a>

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

With your own apps, for best results build 64-bit Xojo apps for distribution on 64-bit Linux systems.

<tbody> </tbody>

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/17	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

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

ldd Xojo

<a id="International Components for Unicode" name="International Components for Unicode">International Components for Unicode</a> (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.