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.

License File Location and Naming​

The license file must be named m2m2.license.xml and placed in the Mango data directory, under a data/core subfolder:

<MA_DATA>/data/core/m2m2.license.xml

Where MA_DATA is the data directory chosen during installation:

  • Linux (default install via install-mango.sh): MA_HOME and MA_DATA are separate directories. Default paths are /opt/mango (install) and /opt/mango-data (data), so the license goes in:

    /opt/mango-data/data/core/m2m2.license.xml

  • Windows / self-contained installs: MA_DATA often defaults to the same folder as the install directory, so the license goes in:

    <install-dir>\data\core\m2m2.license.xml

Note that this is not the root install directory (MA_HOME).

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 file at <MA_DATA>/data/core/m2m2.license.xml, overwriting any existing license file there.
  7. Ensure the file is owned by the same user Mango runs as (e.g. mango:mango on Linux).
  8. Restart Mango, or wait up to 15 minutes -- Mango automatically re-checks the license file on disk every 15 minutes even without a restart.

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 <MA_DATA>/data/core/ on 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 / Troubleshooting unlicensed status​

If the license status repeatedly reverts from "licensed" to "unlicensed," or never shows as licensed after placing the file:

  1. Verify file location: Confirm m2m2.license.xml is at <MA_DATA>/data/core/m2m2.license.xml, not at the install root (MA_HOME) or the root of the data directory. See License File Location and Naming above.
  2. Check permissions: Ensure the Mango process user can read the file.
  3. Check the GUID: The license's GUID must match the instance's GUID exactly (visible in the Mango UI or via the store grant email).
  4. Review logs: ma.log will log one of: license missing, parse error, invalid signature, GUID mismatch, or version mismatch.
  5. Restart Mango, or wait: Allow up to 15 minutes for the automatic recheck, since Mango re-reads the license file from disk on that interval even without a restart.
  6. This issue has been reported in connection with operating system updates (particularly Windows 10) -- a Mango restart typically resolves it.
  7. Contact support: Email support@radixiot.com with your Mango version, operating system details, and any relevant ma.log entries if the problem persists.

"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