🧭 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
   cd mango
   

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

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

📦 Step 3: Download and Install Mango

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

1. In your terminal, download 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
   

2. Download Mango configuration into C:\mango_data:

   cd C:\mango_data
   curl https://docs-v5.radixiot.com/assets/files/5.0.x/mango.xml -o mango.xml
   

3. Install Mango:

   cd C:\mango_data
   mango install
   mango start
   

   • mango install registers the service wrapper.

   • mango start launches Mango for the first time.

▶️ Step 4: Running Mango

• Once started, open your browser and navigate to:

  http://localhost:8080
  

• Default credentials:

  • Username: admin

  • Password: admin

• To stop or start Mango after initial setup, use:

  mango stop
  mango start
  

• ⚠️ Mango no longer auto-restarts via script. If you want Mango to restart automatically, run it as a Windows service (see 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. Change directory to C:\mango\bin:

   cd C:\mango\bin
   

3. Run Mango manually to view errors:

   mango.cmd
   

4. 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 mango.properties to change the port)

5. 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, then SSL may be misconfigured. In that case:

   • Open C:\mango_data\mango.properties

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

   • Save and restart Mango (mango start)

🏷️ Step 6: Running Mango as a Windows Service

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

   cd C:\mango_data
   

2. If not already present, download the mango.xml and WinSW wrapper:

   curl https://docs-v5.radixiot.com/assets/files/5.0.x/mango.xml -o mango.xml
   curl https://github.com/winsw/winsw/releases/download/v2.11.0/WinSW-x64.exe -o mango.exe -L
   

3. Rename WinSW-x64.exe to mango.exe:

   ren WinSW-x64.exe mango.exe
   

4. Edit mango.xml to point to your directories. Example configuration (edit paths as needed):

   <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. From the same folder (C:\mango_data), install and start the service:

   .\mango install
   .\mango start
   

6. Mango is now registered as a Windows service. You can manage it via Services.msc.

📖 Refer to the WinSW documentation for advanced service options.