Skip to main content

Mango Licensing FAQ

How do I purchase and activate a license?​

If your Mango installation has internet access, the license process can be completed entirely within the Mango UI:

  1. Navigate to Administration > Modules in your Mango instance.
  2. Click the Update License button.
  3. Select the license type you want to purchase and complete the payment with your credit card.
  4. After payment, click the Download License button on the Modules page to install the license.

The license is tied to your Mango instance and is activated automatically upon download.

How do I install a license manually (offline)?​

If your Mango installation does not have internet access, you can install the license file manually:

  1. On a computer with internet access, go to store.mango-os.com and log into your account.
  2. In the left side menu, click Licenses.
  3. Select the license you want to download.
  4. Click the Download license file link at the bottom of the page.
  5. Transfer the m2m2.license.xml file to your Mango server (via USB drive, SCP, or other file transfer method).
  6. Place the m2m2.license.xml file in the root Mango installation directory (<MA_HOME>/).
  7. Restart Mango to activate the license.

The license file must be named exactly m2m2.license.xml and must be placed in the top-level Mango directory, not in a subdirectory.

How do I transfer a license to a new server?​

License transfers require contacting Radix IoT support. A license is bound to the specific Mango instance where it was originally activated. To transfer it:

  1. Note your current license key and the Mango instance GUID (found on the Modules page).
  2. Contact support@radixiot.com with your license key, current instance GUID, and the new instance GUID.
  3. The support team will deactivate the license on the old instance and provide instructions for activating it on the new one.

Do not attempt to simply copy the license file between installations. The license validation is tied to instance-specific identifiers.

Common License Errors​

"You have exceeded the 300 point free license"​

This message appears when you have more than 300 data points configured and the license has not been recognized. Common causes:

  • License not downloaded: After purchasing, you must click "Download license" on the Modules page to actually install it.
  • License file missing: After a Mango reinstallation or upgrade, the m2m2.license.xml file may not have been copied to the new installation.
  • License lost after system update: Operating system updates (particularly on Windows) have been known to interfere with Mango's license validation. Restart Mango and re-download the license from the Modules page.

Resolution: Go to the Modules page and click "Download license." If the license downloads successfully, the point limit will be removed. If the download fails, restart Mango and try again. If the problem persists, contact support@radixiot.com.

License keeps reverting to unlicensed​

If the license status repeatedly reverts from "licensed" to "unlicensed" during normal operation:

  1. Verify the m2m2.license.xml file is in the correct location and has not been deleted or moved.
  2. Check file permissions -- the Mango process must be able to read the license file.
  3. Review ma.log for any license-related error messages.
  4. This issue has been reported in connection with operating system updates (particularly Windows 10). A Mango restart typically resolves it.
  5. If the problem persists, contact support@radixiot.com with your Mango version, operating system details, and any relevant log entries.

"License is not valid for this instance"​

This error occurs when a license file is copied from one Mango installation to another. Each license is bound to a specific instance GUID. Contact Radix IoT support to transfer the license to the new instance.

Module-Specific Licenses​

Some Mango modules require separate licenses beyond the core Mango license. For example, the NoSQL database module requires its own license to function. If a module reports that it requires a license:

  1. Navigate to the Modules page.
  2. Check if the module's license status shows as unlicensed.
  3. Contact support@radixiot.com or purchase the module license through the Mango store.

Contacting Support​

For license issues that cannot be resolved through the steps above, contact Radix IoT support:

  • Email: support@radixiot.com
  • Include: Your Mango version, instance GUID, license key, operating system, and a description of the problem including any error messages from ma.log.
  • Reporting Bugs — How to report issues and gather diagnostic information for support
  • Startup Stuck — Troubleshoot Mango failing to start, which may be license-related
  • Restart Issues — Diagnose problems with Mango restarting or shutting down unexpectedly