+1-757-461-3022 x124

Compatibility Matrix


When upgrading from one version of xTuple ERP to another, you must upgrade both the xTuple desktop application and the underlying database. This is true regardless of which edition you use. xTuple provides assistance with this process with the XTN (xTuple Network) service.

The xTuple Desktop client software runs on Windows, macOS and Linux operating systems.

If you do not see your xTuple ERP version listed in the matrix, it's possible your version is no longer supported. To learn more about xTuple's end-of-life policy, please see the xTuple Supported Versions page.

Reference the Compatibility Matrix When Upgrading xTuple ERP

It is NOT always necessary, however, to upgrade extension packages or other applications which operate with xTuple. That's why this Compatibility Matrix is critical. This matrix is designed to help ensure your extension packages and other applications are compatible with the xTuple ERP version you are currently running — or upgrading to. Find the version of xTuple ERP you are considering in the top row. Scroll down to find the versions of the database server, operating system and xTuple extensions that are compatible.

NOTE: If you are a third-party application developer and wish to have your application information added to the xTuple Compatibility Matrix, we invite you to help us keep this matrix up-to-date.

Using the Compatibility Matrix

The Matrix is used to download and install xTuple's full-feature desktop software. This information may be viewed on any mobile device. However, for download purposes, this page is best used on a desktop computer.

Note: You must have an account on either xtuple.org (recommended) or GitHub, and be logged in to download software. Your website account must be linked to the download capabilities to work properly.

xTuple ERP+CRM release

5.0.0 (github or xtuple.org)

4.12.2 (github or xtuple.org)

4.12.0 (github or xtuple.org)

4.11.3 (github or xtuple.org)

4.11.2 (github or xtuple.org)

4.11.1 (github or xtuple.org)

4.11.0 (github or xtuple.org) 4.10.2 (github or xtuple.org)

4.10.1 (github or xtuple.org) 4.10.0 (github or xtuple.org) 4.9.5 (github or xtuple.org) 4.9.3 (github or xtuple.org) 4.9.2 (github or xtuple.org) 4.9.1 (github or xtuple.org) 4.9.0 (github or xtuple.org) 4.8.1 (github or xtuple.org) 4.8.0 (github or xtuple.org) 4.7.0 (github or xtuple.org)

Operating Systems *

Windows7-Windows 10

Ubuntu 18, 64-bit only (see below)

macOS 10.12 and later (see below)

Windows7-Windows 10

Ubuntu 16, 64-bit only (see below)

macOS 10.9 and later (see below)

Windows7-Windows 10

Ubuntu 14, 64-bit only
Ubuntu 16, 64-bit only (see below)

macOS 10.9 and later (see below)

Windows7-Windows 10

Ubuntu14, 32- and 64-bit

macOS 10.7 and later

Windows7-Windows 10

Ubuntu12-14, 32- and 64-bit

macOS 10.4 - 10.7?

Windows7-Windows 10

Ubuntu12-14, 32-bit only

macOS 10.4 - 10.7?

PostgreSQL *

9.5 - 10.x

requires plv8 and uuid-ossp

9.5 - 10.x

requires plv8 and uuid-ossp

9.3 - 9.6

requires plv8 and uuid-ossp

9.3 - 9.5

requires plv8 and ossp-uuid

9.1 - 9.4

9.2 - 9.4 on Windows servers

requires plv8 and ossp-uuid

9.1 - 9.4

9.2 - 9.4 on Windows servers

9.1 - 9.3

9.2 - 9.3 on Windows server

9.1 - 9.3

Web Portal *

1.1.x (not released yet)

requires Ubuntu 16 or 18 server


requires Ubuntu16 server

pre-release requires Ubuntu16 server not compatible

xdruple-extension (contains the desktop client portions of Web Portal)

1.1.x (not released yet)

1.0.x (github or xtuple.org)

pre-release not compatible

xTuple Updater

2.5.2 (github or xtuple.org)
2.4.0 (github or xtuple.org)

xTuple Connect*

3.9.1 (github or xtuple.org)

3.8.1 (github or xtuple.org) or
3.9.0-rc.2 (github or xtuple.org)

3.8.1 (github or xtuple.org)
3.7.4 (github or xtuple.org)

Desktop extension

4.0.15 (github or xtuple.org)
4.0.3 (github or xtuple.org) 3.8.4 (github)

Fixed Assets

1.8.8 (github or xtuple.org)
1.6.5 (github or xtuple.org) 1.5.2 (github)

Fixed Assets Depreciation

1.8.8 (github or xtuple.org) 1.6.x (xtuple.org) 1.5.3 (github or xtuple.org)

Fixed Assets Maintenance

1.6.x (xtuple.org) 1.5.4 (xtuple.org) 1.5.0 (github or xtuple.org)

Time and Expense

2.5.2 (github or xtuple.org) 2.4.8 (github or xtuple.org)

Project Accounting

1.3.7 (github or xtuple.org)

Enhanced Commissions*

1.9.5 (github or xtuple.org), not compabible with xwd (extended Distribution features)

NodeJS shim 

1.0.2 (github or xtuple.org) not compatible

xTuple Dashboards

1.0.4 (github or xtuple.org)

requires NodeJS shim extension v1.0.2

not compatible

Enhanced Pricing - Discounts and Promotions

1.0.2 (github or xtuple.org)

not compatible

Payment Gateways -advanced credit card handling

1.0.5 (github or xtuple.org)

not compatible

QuickStart Wizard

3.8.2 (github or xtuple.org) 3.8.0 (xtuple.org)

Upgrading utilities

Extensions to help you pilot and upgrade

Download (github or xtuple.org), install, and use the updatetodb extension before putting 5.0.0 into production

Download (github or xtuple.org), install, and use the fixcountry and deprecatedtb extensions before upgrading to 5.0.0

Operating Systems

xTuple ERP will run on a wide range of different operating systems and platforms. It is not possible for us to test every single combination. However, the following list offers basic guidelines for those preparing to install or upgrade xTuple ERP.

  • Windows — Windows 7 to Windows 10 are widely used and supported, though earlier versions may also work. Our in-house builds run on Windows 7.
  • Linux — Ubuntu and Fedora are widely used, though other flavors of Linux may also work. APT packages of PostBooks probably will run but were not created by xTuple, so support is not guaranteed.
    To run on Ubuntu 16 you must install some backwards-compatibility packages:
    sudo add-apt-repository -y "deb http://ftp.debian.org/debian trusty-backports universe restricted main"
    sudo add-apt-repository -y "deb http://us.archive.ubuntu.com/ubuntu trusty restricted multiverse main universe"
    sudo add-apt-repository -y "deb http://us.archive.ubuntu.com/ubuntu trusty-updates restricted universe main multiverse"
    sudo add-apt-repository -y "deb http://us.archive.ubuntu.com/ubuntu trusty-backports main restricted universe multiverse"
    sudo add-apt-repository -y "deb http://security.ubuntu.com/ubuntu trusty-security main multiverse universe restricted"
    sudo apt-get update
    sudo apt-get install libwebp5 libgstreamer0.10-0 libgstreamer-plugins-base0.10-dev libgstreamer0.10-dev libicu52

The xTuple ERP client applications are built and tested with specific versions of Qt. If you have problems, particularly if you're running on distribution other than Ubuntu, the issues may be related to the Qt libraries installed on your system. Updater 2.5.0 is particularly sensitive to this, reporting false failures on certain prerequisite checks.

  • Mac — xTuple ERP version 5.0.0 requires macOS 10.12 or newer. Prior to version 5.0.0 and beginning with xTuple ERP version 4.10.0, we require macOS 10.7 or later. Prior to version 4.10.0, a wider range was supported. Companies that accept credit cards must upgrade to at least macOS 10.9 and xTuple ERP 4.10.2 or xTuple ERP 4.11.0RC to avoid network connection failures when processing credit card transactions.


xTuple ERP runs on the open source PostgreSQL database. As a general rule, xTuple ERP supports multiple versions of PostgreSQL. However, there are some limitations, and it's important to make sure your PostgreSQL and xTuple ERP versions are in sync.

Please Note: Beginning with xTuple ERP version 4.9.0, all supported PostgreSQL versions must have the plv8 extension added to them. For more information, please see our detailed instructions on installing plv8.

Web Portal

A customer-facing Web Portal providing online access and real-time syncing with the back-end xTuple ERP database.

xTuple Connect

xTuple Connect operates with all xTuple ERP Editions. The xTuple Connect application consists of two parts: a GUI client and an extension package (xtbatch). The xTuple Connect GUI client version will always be the same as the xTuple Connect extension package version.

320 users have voted.