Nuxeo Server

Installing the Nuxeo Platform on Mac OS

Updated: November 13, 2017 Page Information Edit on GitHub

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

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

Checking Requirements

Check out the Installation page 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 the Nuxeo Platform Using Homebrew

If you are not familiar with Homebrew, you can have a look at their documentation.

To install Nuxeo using Homebrew:

brew install nuxeo

The nuxeo.conf file will be in located in /usr/local/etc/nuxeo.conf. You can now start your server with nuxeoctl as it is added in your PATH.

Installing the Nuxeo Platform Using Docker

If you are familiar with docker, you can also get the Nuxeo Docker image, you can find more information on Docker hub.

You can also have a look to Setting up your Nuxeo page which explain more about usage of Nuxeo Docker image.

Installing a Nuxeo Virtual Machine Image

The Nuxeo Platform is available as ready-to-use 64b virtual machine images from nuxeo.com. 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. 

Limitations:

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

4 days ago manonlumeau Added content-review-lts2017 label
a month ago manonlumeau NXDOC-1346-FT review screenshot
2 years ago Manon Lumeau 28
2 years ago Manon Lumeau 27 | Add homebrew step
2 years ago Manon Lumeau 26
2 years ago Alain Escaffre 25
2 years ago Manon Lumeau 24
2 years ago Solen Guitter 23
3 years ago Solen Guitter 22 | Fix broken excerpt of vm installation
3 years ago Solen Guitter 21
3 years ago Solen Guitter 20
3 years ago Solen Guitter 17
3 years ago Solen Guitter 18 | Migration of unmigrated content due to installation of a new plugin
3 years ago Solen Guitter 19 | Migration of unmigrated content due to installation of a new plugin
3 years ago Solen Guitter 16
3 years ago Solen Guitter 15 | Add Checking requirements section
4 years ago Solen Guitter 11
4 years ago Solen Guitter 12 | Migration of unmigrated content due to installation of a new plugin
4 years ago Solen Guitter 13 | Migration of unmigrated content due to installation of a new plugin
4 years ago Solen Guitter 14 | Migration of unmigrated content due to installation of a new plugin
4 years ago Solen Guitter 9
4 years ago Solen Guitter 10
4 years ago Solen Guitter 8
6 years ago Solen Guitter 3
6 years ago Solen Guitter 4 | Migrated to Confluence 4.0
6 years ago Solen Guitter 5 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 6 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 7 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 2 | Added links to next steps
6 years ago Solen Guitter 1
History: Created by Solen Guitter