General Installation Process
Installing the Nuxeo Platform requires a few steps:
- Have a look at the Software Requirements in the section below.
- 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 |
|
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:
|
More information on installing third-party software. |
Checking Your Java Version
To check that you have the right version of Java:
Open a terminal:
- On Linux or macOS: open a terminal.
- On Windows: press the "Windows" key + r, type
cmd
(orcommand
) 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)
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).