Skip to main content

Installation Overview

Recommended: Docker Installation

For new deployments, Docker is the recommended installation method. It provides a consistent, reproducible environment with minimal configuration. See Installing with Docker for instructions.

The following steps are an overview of how to manually install and run Mango.

  1. Download and install Java JDK — see Java Requirements for details.
  2. On Linux or macOS, you can use the install script to automate the process.
  3. Download the Mango zip file from the Mango Store.
  4. Extract the zip file into a directory of your choice (e.g. /opt/mango or C:\mango).
  5. Set the mango_paths_home environment variable to the path where you installed Mango (recommended but not required).
  6. Edit mango.properties to suit your configuration — see Configuration File for details. Note: Properties file will not be created until after the initial startup of Mango.
  7. Start Mango by running $mango_paths_home/bin/start-mango.sh (Linux and Mac) or %mango_paths_home%\bin\mango.cmd (Windows) from your terminal / command prompt window respectively.

NOTE: Previously Mango used to restart itself via a script. Mango no longer does this, if you want Mango to restart automatically you should start it via systemd or a Windows service.

For more detailed instructions please see the following links for each supported operating system:

Logging in for the first time​

Mango ships with a default admin user. After logging in for the first time, the admin user’s password should be changed.

  • Navigate to the web interface using a supported browser. http://localhost:8080/ or http://your_mango_ip:8080
  • Log in with the username admin and password admin.
  • You must read the Mango license which is presented and agree to its terms.
  • Change the admin user's password.