Windows Installation

How to install Mango in Windows

July 13th, 2021


Installing Mango Automation on a Windows computer is very easy. Follow these steps.

  1. Download and install Java JDK 11
  2. Download the Latest Full Mango Zip file from the website
  3. Unzip Mango into your folder of choice.

Running Mango

  1. Open File explorer and navigate to C:\<your mango directory>\bin such as CD C:\Program Files\Mango\bin.
  2. Double click mango.cmd.
  3. Once mango has started, you can log into the dashboard by opening your browser and going to localhost:8080.
  4. The default username and password are both admin.

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 as a Windows service.

Running Mango as a service

  • Open cmd.exe and navigate to your %mango_paths_data% location.
  • Run the following command to download the mango.xml file into your data directory. curl https://raw.githubusercontent.com/MangoAutomation/ma-core-public/main/Core/bin/mango.xml
  • Download the latest WinSW v2.x.x release (the provided configuration file will not work for version 3) from Github (.NET Core packaging recommended, e.g. WinSW-x64.exe)
  • Place WinSW-x64.exe in the %mango_paths_data% directory.
  • Rename WinSW-x64.exe to mango.exe.
  • Modify the file to point the variables at the correct directories.
<service>
  <id>mango</id>
  <name>Mango Automation</name>
  <description>Mango Automation by Radix IoT LLC.</description>

  <env name="mango_paths_home" value="C:\<Your Mango Root Dir>"/>
  <env name="mango_paths_data" value="C:\<Your mango data Dir>"/>
  <env name="mango_config" value="C:\<Path to your mango.properties file>"/>

  <workingdirectory>%mango_paths_home%</workingdirectory>
  <executable>java</executable>
  <arguments>-jar %mango_paths_home%\boot\ma-bootstrap.jar</arguments>
  <!-- Mango does its own logging -->
  <log mode="none"/>
  <onfailure action="restart" delay="10 sec"/>
  <stoptimeout>300sec</stoptimeout>
</service>
  • Using cmd.exe, ensure you are in the %mango_paths_data% directory and run the following commnads:
.\mango install
.\mango start
  • Once installed you can start and stop via services.msc. Windows service

  • Please see the WinSW documentation for more configuration options.

Troubleshooting

After clicking on the /bin/mango.cmd file if you see anything or something popped up and closed quickly then there was an error.

To see the error, first open the Command Prompt by typing “cmd” into your start menu. Right click on it and select “Run as Administrator”.

Change directories to your Mango\bin folder. Now you can type mango.cmd and watch the start up procedure. If there is a conflict with your system, you will see the error in the terminal.

Common Startup issues:

  1. JDK not installed
  2. JAVA_HOME Not Set correctly
  3. Something else occupying the port Mango is starting on. By default, Mango uses port 8080. You can modify this by placing a new env.properties file into the /overrides/properties directory. Detailed instructions can be found here

Copyright © 2021 Radix IoT, LLC.