Installation and Administration

Installing the Nuxeo Platform on Mac OS

Updated: August 27, 2021

On Mac OS, you can install the Nuxeo Platform using two different packages:

  • The nuxeo-server-<version> archive
  • The virtual machine image (VirtualBox or VMware)

Checking Requirements

The only requirement to run the Nuxeo Platform is to have Java 8u40 (also called Java 1.8.0_40) or a more recent version installed. You need a Java Development Kit (JDK) to develop on the platform, but a JRE is enough to just run it.

Check out the Hardware and Software Requirements for detailed steps to check your Java version and install it.

Installing the Nuxeo Platform From the .zip Archive

Installing the Nuxeo Platform using the .zip package installs the Nuxeo Platform only. External dependencies must be installed separately.

To install the Nuxeo Platform zip archive: Unzip the .zip archive using your favorite tool.

What's next? You want to evaluate the application? You can now start the server. You want to do a complete installation, compatible for a production environment? You should now prepare your environment.

Installing a Nuxeo Virtual Machine Image

The Nuxeo Platform is available as ready-to-use 64b virtual machine images from VM images are available for VMWare and Virtual Box. They provide a full environment (OS, database…) and all required dependencies to make the Nuxeo Platform work.

To install the Nuxeo virtual machine image and start Nuxeo:

  1. Unzip the downloaded package.

    Do not use the Windows built-in ZIP functionality (aka "zipfldr.dll" or "Compressed Folders Module"), it reports incorrect uncompressed size. Recommended: 7-Zip.

    You get a folder with the required file for the virtual machine image to run.

  2. Start the virtual machine image in your virtual machine application by double-clicking on it.

    • For the VMWare package, double-click on the file "nuxeo.vmx".
    • For the OVF package: in VirtualBox, go to the File menu and choose Import Appliance. Then start the imported virtual machine.The VM image starts.
      Then, the Nuxeo application automatically starts.
      When the Nuxeo application is started, it displays the address at which it is available.
  3. In your browser, type the indicated address. The startup wizard is displayed to help you configure your application.

    Shell root access

    The password for the root and nuxeo users are generated the first time you start the virtual machine and are displayed on the console.


  • As a 64 bit virtual image, it cannot be installed on a 32 bit system.
  • MP4 video conversion is not supported because of distribution rights limitations.

We'd love to hear your thoughts!

All fields required