+1-757-461-3022 x124

Compatibility Matrix


When upgrading from one version of xTuple ERP to another, you are also required to upgrade the core xTuple software. For PostBooks® users, the core PostBooks® database must be upgraded also. For Commercial Edition users, the core commercial database must be upgraded as well.

Performing an upgrade to xTuple's core software is a prerequisite for moving from one version of xTuple ERP to the next. 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.

xTuple ERP+CRM release



4.11.0, 4.10.2

4.10.1 4.10.0 4.9.5 4.9.3 4.9.2 4.9.1 4.9.0 4.8.1 4.8.0 4.7.0 4.6.0 4.5.2 4.5.1 4.5.0

Operating Systems *

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.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

xTupleCommerce (commercial) *

requires Ubuntu16 server not compatible

xTuple Updater

2.4.0 or the experimental 2.5.0Beta 2.4.0
2.2.5 - 2.4.0

xTuple Connect (commercial) *

3.8.1 (github or xtuple.org) or the experimental 3.9.0Beta 3.8.1 (github or xtuple.org)
3.7.4 (github or xtuple.org)

Desktop extension (free)

4.0.10 4.0.3 3.8.4

Fixed Assets (free)

1.8.1 1.6.5 1.5.x

Fixed Assets Depreciation (commercial)

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

Fixed Assets Maintenance (commercial)

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

Time and Expense (free)

2.4.5 2.3.0

Project Accounting (commercial)

1.3.3 (github or xtuple.org)

Enhanced Commissions (commercial) *

1.9.2 (github or xtuple.org)

NodeJS shim (free)

1.0.0 not compatible

xTuple Dashboards (commercial)

1.0.1 (github or xtuple.org)

requires NodeJS shim extension v1.0.0 or later

not compatible

QuickStart Wizard (commercial)


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
  • Mac — 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.


xTupleCommerce is a Customer Web Portal providing online access and real-time syncing with the back-end xTuple ERP database.

xTuple Connect

xTuple Connect is a commercial application which 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.

Enhanced Commissions

The Enhanced Commissions package (xtcommission) is a commercial package which can be added to any edition of xTuple ERP. Please Note: At the present time, the Enhanced Commissions package is not compatible with the Distribution Edition.

119 users have voted.