🧭 Overview

Installing Mango Automation on a Windows computer is straightforward. This guide walks you through:

1. Setting up Java JDK 17 (Azul Zulu OpenJDK)

2. Downloading and installing Mango

3. Running Mango from the command line

4. Configuring Mango as a Windows service

5. Basic troubleshooting steps

🔧 Prerequisites

• Windows 10 or later

• Administrator privileges

• Internet access to download Java and Mango packages

📥 Step 1: Install Java JDK 17

1. Download and install Java JDK 17 (Adoptium Temurin 17 or Zulu OpenJDK 17).

2. After installation, verify Java is accessible:

   java -version

3. Ensure the JAVA_HOME environment variable points to your JDK installation folder (e.g., C:\mango\openJDK).

4. Add %JAVA_HOME%\bin to your system Path so that java.exe can be run from any command prompt.

💡 Tip: To prevent system-wide Java updates from affecting Mango, install the JDK inside your Mango installation directory, e.g., C:\mango\openJDK.

🛠 Step 2: Create Mango Directories

1. Open Command Prompt or PowerShell as Administrator.

2. Run the commands below (modify paths as needed):

   cd C:\
   mkdir mango
   mkdir mango_data

   • C:\mango will be the Mango home directory.

   • C:\mango_data will be the Mango data directory.

📦 Step 3: Download and Extract Mango

⚠️ Note: The current Mango version is enterprise-m2m2-core-5.4.1.zip. Modify the URL to install a different version if desired.

1. Download and extract Mango into C:\mango:

   cd C:\mango
   curl https://store.mango-os.com/downloads/fullCores/enterprise-m2m2-core-5.4.1.zip -o mango.zip
   tar -xvf mango.zip
   del mango.zip

   The zip extracts its contents directly into the current directory — no subdirectory is created. After extraction, C:\mango will contain folders such as bin\, boot\, lib\, and web\.

▶️ Step 4: Run Mango from the Command Line

1. Open Command Prompt as Administrator and run:

   C:\mango\bin\mango.cmd

2. Once started, open your browser and navigate to:

   http://localhost:8080

3. Default credentials:

   • Username: admin

   • Password: admin

⚠️ Running Mango via mango.cmd is tied to the Command Prompt window. If you close the window, Mango will stop. To run Mango as a persistent background service that starts automatically with Windows, complete Step 6.

🛠️ Step 5: Troubleshooting

If Mango fails to start or its console window closes immediately, do the following:

1. Open a new Command Prompt as Administrator.

2. Run Mango manually to view errors:

   C:\mango\bin\mango.cmd

3. Look for errors — common issues include:

   • JDK not installed or java -version fails

   • JAVA_HOME not set correctly

   • Port 8080 in use by another application — edit C:\mango_data\mango.properties and set web.port to an available port

4. If Mango stops abruptly and you see a log entry like:

   INFO  2025-05-23T09:10:13,970 (com.serotonin.m2m2.Main.loadModules:714) - Loading module 'internal', v5.4.1 by Radix IoT

   with no further log entries, SSL may be misconfigured. In that case:

   • Open C:\mango_data\mango.properties

   • Find any ssl.* settings (e.g., ssl.enabled=true) and set them to false

   • Save the file and restart Mango

🏷️ Step 6: Run Mango as a Windows Service

Running Mango as a Windows service allows it to start automatically with Windows and restart automatically if it crashes.

1. Open Command Prompt as Administrator and navigate to your data directory:

   cd C:\mango_data

2. Copy the bundled service configuration file from your Mango installation:

   copy C:\mango\bin\mango.xml C:\mango_data\mango.xml

3. Download the WinSW service wrapper and save it as mango.exe:

   curl https://github.com/winsw/winsw/releases/download/v2.11.0/WinSW-x64.exe -o mango.exe -L

4. Open C:\mango_data\mango.xml and verify the paths match your installation. The key entries should read:

   <service>
     <id>mango</id>
     <name>Mango Automation</name>
     <description>Mango Automation by Radix IoT LLC.</description>
     <env name="mango_paths_home" value="C:\mango" />
     <env name="mango_paths_data" value="C:\mango_data" />
     <env name="mango_config" value="C:\mango_data\mango.properties" />
     <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>

5. Install and start the Windows service:

   .\mango install
   .\mango start

6. Mango is now registered as a Windows service and will start automatically on boot. You can also manage it via Services.msc.

📖 Refer to the WinSW documentation for advanced service options such as log rotation and delayed start.