Nuxeo Server

Installing the Nuxeo Platform on Windows

Updated: September 22, 2017 Page Information Edit on GitHub

You can install the Nuxeo Platform on Windows using one of several methods:

  • the Windows installer (.exe)
  • the ZIP archive (.zip)
  • the Virtual Machine Image (.ovf, .vmdk, .vmx)

See our Download page.

Checking Requirements

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

Installing the Nuxeo Platform from the Windows Installer

The Nuxeo Platform is available with a Windows installer that guides you in the install process.

The Windows installer requires Administrator privileges.

To install the application using the Windows installer (.exe), double-click on the .exe installer you downloaded and follow the instructions displayed.

Installation path

On Windows in general, and especially on Windows 7, it is highly recommended to install your Nuxeo application at the root of a disk (C:\Nuxeo for instance), because of rights issues, limitations on paths length, 32/64 bits conflicts,... An installation in another folder could provoke restart issues at end of the startup wizard steps.

  • The Windows installer includes a full JDK installation. You will get an error while installing the JavaFX portion. The JavaFX platform is not used by Nuxeo, therefore, when the error appears, click Close and continue with the installation.
  • When you launch the Nuxeo services for the first time, you will see an error window that says pdftohtml.exe has stopped working. To get the pdftohtml utility to work properly, install the Visual C++ Redistributable for Visual Studio 2012 available on Microsoft's website.
  • If you are using PostgreSQL, please review the PostgreSQL document and use the recommended configurations.

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 from the ZIP Archive

Installing the Nuxeo Platform using the ZIP archive installs the Nuxeo Platform only. External dependencies must be installed separately.

To install the Nuxeo Platform ZIP archive:

Unzip the .zip archive.

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

Installation path

On Windows in general, and especially on Windows 7, it is highly recommended to install your Nuxeo application at the root of a disk (C:\Nuxeo for instance), because of rights issues, limitations on paths length, 32/64 bits conflicts,... An installation in another folder could provoke restart issues at end of the startup wizard steps.

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

 

 


2 days ago Solen Guitter Don't show excerpt 'upgrade-9.2-drop-change-token' and add comment
a year ago Manon Lumeau 38
2 years ago Alain Escaffre 37
2 years ago Manon Lumeau 36
2 years ago Julien Carsique 35
3 years ago Solen Guitter 33
3 years ago Solen Guitter 34
3 years ago Solen Guitter 32
3 years ago Solen Guitter 31
3 years ago Solen Guitter 30
3 years ago Solen Guitter 29 | Only 1 ovf file remains
3 years ago Solen Guitter 28 | Added limitations on VM installation
3 years ago Solen Guitter 27
3 years ago Solen Guitter 26 | Add Checking requirements section
4 years ago Solen Guitter 25
4 years ago Harlan Brown 24
4 years ago Harlan Brown 23
4 years ago Solen Guitter 22
4 years ago Harlan Brown 21
4 years ago Solen Guitter 20
4 years ago Mathieu Guillaume 19
4 years ago Thibaud Arguillere 18
4 years ago Solen Guitter 17 | Changed recommended path installation from root of C:\ to root of any disk
4 years ago Solen Guitter 15
4 years ago Solen Guitter 16
4 years ago Solen Guitter 14
4 years ago Solen Guitter 13
5 years ago Solen Guitter 11
5 years ago Solen Guitter 12 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 7 | Added details on VM installation
6 years ago Solen Guitter 8 | Migrated to Confluence 4.0
6 years ago Solen Guitter 9 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 10 | Migration of unmigrated content due to installation of a new plugin
6 years ago Solen Guitter 6 | Added toc
6 years ago Solen Guitter 5 | Added related content
6 years ago Solen Guitter 4
6 years ago Solen Guitter 3
6 years ago Solen Guitter 1
6 years ago Solen Guitter 2
History: Created by Solen Guitter