Skip to main content

Updating the Mango Store Path

As part of the Mango Automation rebranding, the URL for the Mango module store has changed. If you are running a version of Mango prior to 4.2, you may need to update the store.url property in your mango.properties file to ensure that module downloads, license validation, and upgrade checks continue to work.

note

If you are running Mango v4.2 or above, your store path should already be correct and no changes are necessary.

If you are running Mango v3, refer to the v3-specific instructions instead.

Checking Your Current Configuration​

  1. Open your mango.properties file in a text editor.
  2. Locate the store.url property.
  3. If the property is not present or is commented out (starts with #), no changes are needed. Mango will use the correct default store URL.
# The location of the Mango Automation store from which to get license files.
store.url=https://store.mango-os.com

Updating the Store Path​

If the store.url property is set to an old URL, comment it out by adding a # at the beginning of the line:

# The location of the Mango Automation store from which to get license files.
#store.url=https://store.mango-os.com

Save your changes and upgrade to Mango version 4.2.x or higher. The new version includes the correct default store URL.

Why This Matters​

The store URL is used for several critical functions:

  • License validation -- Mango contacts the store to validate your license on startup.
  • Module downloads -- When you install or upgrade modules from the Modules page, they are downloaded from the store.
  • Upgrade checks -- The daily automatic upgrade check contacts the store to determine if new versions are available.

If the store URL is incorrect, these functions will fail silently or produce errors in the log file. Common symptoms include:

  • "Unable to contact store" errors on the Modules page
  • License validation failures
  • Upgrade notifications not appearing

Troubleshooting​

If you continue to have store connectivity issues after updating the URL:

  1. Check network connectivity -- Ensure the Mango server can reach https://store.mango-os.com on port 443. Test with: curl -v https://store.mango-os.com
  2. Check proxy settings -- If your server uses an HTTP proxy, configure the proxy settings in mango.properties.
  3. Verify the license -- An expired or invalid license may produce similar symptoms. Check the license status on the Modules page.
  4. Review logs -- Check MA_HOME/logs/ma.log for store-related error messages.