Installation and Administration

Server Start and Stop

Updated: October 16, 2020

On this page, you will see how to start and stop your Nuxeo application.

Nuxeo applications come with a Control Panel that allows you to start and stop the server easily, and to access more administration features.

The Control Panel gives you access to:

  • A summary of the server status: is it running, is stopped, etc...
  • The logs of the server: the console and server logs are information of the tasks the server is doing and messages on how it is processing these tasks.
  • The Nuxeo Shell: the administrators' Swiss Army knife.

Here are the different ways to start and stop your Nuxeo application, depending on your OS:

Starting Your Nuxeo Application

By default, you cannot run two Nuxeo applications at the same time. If you want to run two Nuxeo applications at the same time (for instance a Nuxeo DM and a Nuxeo DAM), you need to change the default port used by one of the Nuxeo servers.

Depending on your OS, there are different ways to start the application. The steps below show how to use the Control Panel to start the server. However, you can use the command below in a terminal if you prefer. From the $NUXEO_HOME/bin, execute nuxeoctl start. You can refer to the nuxeoctl and Control Panel Usage for more information on the nuxeoctl command and the Control Panel.

Starting Your Application on Windows

  1. Open the Nuxeo Control Panel:
    1. In the folder C:\Nuxeo application, double-click on Start Nuxeo.bat.
    2. In the folder C:\Nuxeo application\bin\, double-click on nuxeoctl.bat. The Nuxeo Control Panel opens.
  2. Click on the Start button. Starting the Nuxeo server takes between a few seconds and several minutes, depending on your hardware and the distribution you have chosen to install. When the server is started, the Start button becomes a Stop button.
  3. Open a browser and type the URL http://NUXEO_SERVER/nuxeo.

If the server is started for the first time after the installation, the startup wizard is displayed so you can select what module you want to install on the platform and help you configure it. Otherwise, the login page is displayed so you can use the application.

On Windows 7, you need to run the nuxeoctl.bat and Start Nuxeo.bat commands as an administrator if you haven't installed your Nuxeo application at the root of C:\ (for instance in C:\Program Files). To run them as an administrator, right-click on the command and click on "Run as administrator".

On Windows, it is possible to start Nuxeo as a service. Please report the [Installing the Nuxeo Platform as a Windows service] page for guidelines and examples.

Starting Your Application on Linux

Nuxeo applications are started using scripts.

  1. Launch a terminal and go to your installation directory.
  2. Start the server using the nuxeoctl script (located in the bin directory):
    ./bin/nuxeoctl start --gui
    
    The command used to launch the Control Panel may not be executable by default. If it is the case, in the terminal go to the bin directory of Nuxeo and type the line below to be able to use it:
    chmod +x *.sh *ctl
    
    The Control Panel opens.
  3. Click on the Start button. Starting the Nuxeo server takes between 30 sec and several minutes, depending on your hardware and the distribution you have chosen to install. When the server is started, the Start button becomes a Stop button.
  4. Open a browser and type the URL http://NUXEO_SERVER/nuxeo. If the server is started for the first time after the installation, the startup wizard is displayed so you can select what module you want to install on the platform and help you configure it. Otherwise, the login page is displayed so you can use the application.

Starting Your Application on Mac OS X

Mac OS users can use either the same steps as Linux users or some Mac OS convenient commands (see below).

  1. From the Finder, click on "Start Nuxeo.command". You can also drag and drop the start script in the terminal and press Enter.

    The command may not be executable by default. If it is the case, in the terminal go to the bin directory of Nuxeo and type the line below:

    chmod +x *.command
    

    The Control Panel opens.

  2. Click on the Start button. Starting the Nuxeo server takes between 30 sec and several minutes, depending on your hardware and the distribution you have chosen to install. When the server is started, the Start button becomes a Stop button.
  3. Open a browser and type the URL http://NUXEO_SERVER/nuxeo. If the server is started for the first time after the installation, the startup wizard is displayed so you can select what module you want to install on the platform and help you configure it. Otherwise, the login page is displayed so you can use the application.

Stopping Your Nuxeo Application

The steps to stop your Nuxeo application are the same for all operating systems.

To stop your server:

  1. On the Control Panel, click on the Stop button. Stopping the server takes several seconds. When the server is stopped, the Stop button becomes a Start button.
  2. Close the Control Panel.

If you started the server using the nuxeoctl start command in the terminal, use the nuxeoctl stop command to stop it.