Server

Tomcat Server ZIP

Updated: March 18, 2024

General Installation Process

Installing the Nuxeo Platform requires a few steps:

  1. Have a look at the Software Requirements in the section below.
  2. Install and Set up the related software. Install and start the Nuxeo Platform server. To understand how to start a Nuxeo Platform server on different environments, you can read and follow one of our recipes:

Software Requirements

The following table lists the current requirements for running the Nuxeo Platform from the Tomcat server ZIP archive.

If you have requirements and/or constraints are not reflected below, do not hesitate to contact the Nuxeo team to evaluate the feasibility of running Nuxeo on any other environment.

OS
  • Linux
  • macOS
  • Windows
Note: the only limitation on OS nature and version is the ability to install the correct version of the required JDK (see below). It means that while it is commonly reported to run on recent versions of Ubuntu, RHEL, Debian, CentOS, it can also run on any Linux distribution where it is possible to install the required JDK. You may have to adapt the provided startup shell scripts.
Java JDK 11 (Azul's Zulu OpenJDK or Oracle's JDK) See the following documentation:
Optional Third-Party Software Some third party software may be required depending on the conversions capabilities you want to benefit from. The following list is not exhaustive:
  • LibreOffice
  • ImageMagick
  • FFmpeg
  • Docker
  • pdftohtml
  • Ghostscript
  • Exiftool
More information on installing third-party software.

Checking Your Java Version

To check that you have the right version of Java:

  1. Open a terminal:

    • On Linux or macOS: open a terminal.
    • On Windows: press the "Windows" key + r, type cmd (or command) in the Run window and press "OK" (or open the Command Prompt from Start > Programs > Accessories in Windows 7 or entering Command Prompt in Cortana in Windows 10)
  2. Type java -version and press Enter. If Java is correctly installed on your computer, the name and version of your Java virtual machine is displayed:

    openjdk version "11.0.8" 2020-07-14 LTS
    OpenJDK Runtime Environment Zulu11.41+23-CA (build 11.0.8+10-LTS)
    OpenJDK 64-Bit Server VM Zulu11.41+23-CA (build 11.0.8+10-LTS, mixed mode)
    

    Check in the output that the JDK version is 64 bits.

    If Java is not installed on you computer, it will fail to display the Java version. In this case, install Java (see below).

    If Java is installed but not included in the PATH, it will fail to find the Java command. In that case, you need to add $JAVA_HOME/bin/ to your PATH (see How do I set or change the PATH system variable?).

    To ensure you installed a Java Development Kit environment, type javac -version and press Enter.

    If you installed a JDK, the javac version is displayed:

    javac 11.0.8
    

    If you installed a Java Runtime Environment instead of a Java Development Kit, it will fail to find javac and to display the javac version. In this case, install a Java Development Kit (see below).

Installing Java Development Kit

Java packages and instructions for installation are available from the Azul website:

As for any software, we very strongly recommend upgrading to the latest bugfix version of the JDK for any given major version.

After installing the Java Development Kit, verify that the JAVA_HOME system variable correctly points to the Java Development Kit intended for running the Nuxeo Platform (JAVA_HOME should be set if it is not present).