Prerequisites overview

This document provides an overview of the prerequisites to install the different upgrades of Sage X3.

Databases

Notes:

• The MongoDB installer is included in the Sage X3 ISO.
• MongoDB versions under 4.2 are not compatible with Windows Server 2019.
• MongoDB 4.4 is not compatible with Windows Server 2012 R2.
• Since release 2025 R1/V12.0.37, Sage X3 does not support Windows Server 2016.

• As of April 2025, MongoDB 7 and MongoDB 8 are not yet certified on Windows Server 2025. As a consequence, we recommend using Windows Server 2022 until Windows Server 2025 offers support for MongoDB 7 and MongoDB 8.

• Since September 2025, Windows Server 2025 offers support for Oracle 19c. The Oracle 19.27 patch is required for Windows Server 2025 to offer support for Oracle 19c.

Microsoft PowerShell

PowerShell is a cross-platform task automation solution composed of a command-line shell, a scripting language, and a configuration management framework. PowerShell runs on Windows, Linux, and macOS.

Below, you can find the requirements for the runtime and database server for each release prior to and since release 2022 R4/V12.0.32:

For more details, consult the installation documentation.

Server operating system

For Red Hat and Oracle, check the list of prerequisites here.

Note: Windows Server 2012 R2 should not be used for new installations, as:

• Its End of Life is planned for October 10, 2023.
• Sage stopped supporting Windows Server 2012 R2 in 2022.
• If you are currently using Windows Server 2012 R2, you need to upgrade to Windows Server 2019, 2022, or 2025.

Note: Since release 2025 R1/V12.0.37, Sage X3 does not support Windows Server 2016.

• If you are currently using Windows Server 2016, you need to upgrade to Windows Server 2019, 2022, or 2025.

Servers, frameworks, and middleware

The following components contain a validated version of Node.js to be installed within the setup pack:

• Syracuse web server

• X3 Services

• Automated Test Platform (ATP)

Some components of Sage X3 will also install a validated version of the Microsoft .NET Framework.

Browsers

Note: Desktop browsers are certified on Windows 7, Windows 8.1, Windows 10 (Edge only on Windows 10), Windows 11, and Mac OS X. Other Linux-based systems are "compatible only."

Mobile applications

Client components

Note:

• Office and Outlook as part of Office 365 do not have support for Office online.

• To use Crystal Reports Designer 2016 and 2020, the Print Server version must be ≥ 2.18.

Virtualization platforms

You can run Sage X3 on a virtualization platform. This is supported if:

• The operating system used in the Sage X3 virtual machines:
  • Is certified by the virtualization platform vendor.
  • Is supported by Sage X3.
• The virtualized environment is correctly configured and managed according to virtualization platform and hardware vendors’ good practices, particularly:
  • Lowest possible latency between the database tier and the application/runtime tier.
  • No (or very little) CPU over-provisioning.
  • No or moderate memory over-provisioning.
  • Plenty of storage IOPs for the database tier. SSD highly recommended.