Release Notes
This section documents the version history of the Mango platform by Radix IoT, including detailed changelogs, major feature highlights, and upgrade guidance for administrators planning version transitions.
Versioning Model
Starting with Mango 5.0, Radix IoT adopted a unified versioning system. Under this model, every release ships the core platform and all official modules together as a single versioned bundle. When any component receives an update, whether it is the core runtime, a data source module, or a UI enhancement, the entire platform is released as a new version. For example, if the Watchlist module receives a patch, the full bundle is released as the next incremental version (e.g., 5.0.1).
Version numbers follow semantic versioning conventions:
- Major versions (e.g., 5.0.0) introduce significant architectural changes, new features, or breaking changes that may require migration steps. A new license is typically required when upgrading across major versions.
- Minor versions (e.g., 5.5.0) add new features, module enhancements, and library upgrades while maintaining backward compatibility within the major release line.
- Patch versions (e.g., 5.5.7) contain bug fixes, security patches, and stability improvements with no breaking changes.
Java Runtime Requirements
Each major version of Mango specifies minimum and recommended Java versions:
| Mango Version | Minimum Java | Recommended Java | Build Java |
|---|---|---|---|
| 5.0.x -- 5.3.x | Java 17 | Java 17 | Java 17 |
| 5.4.x -- 5.5.x | Java 17 | Java 21 | Java 21+ |
| 5.6.x | Java 17 | Java 21 | Java 25 |
Radix IoT recommends the Azul Zulu builds of OpenJDK, though any compliant OpenJDK distribution is supported.
Upgrade Path Recommendations
When planning an upgrade, keep these guidelines in mind:
- Always back up your database and configuration before upgrading. Test the upgrade in a non-production environment first.
- Upgrade within a major version by applying the latest patch release. These are designed to be drop-in replacements with no migration steps.
- Upgrade across major versions by following the dedicated upgrade guide. Major version upgrades may require a new license, Java version changes, and database migrations.
- Review the release notes for every version between your current version and your target version to identify any breaking changes, deprecated features, or required configuration updates.
In This Section
| Page | Description |
|---|---|
| v5 Release Notes | Complete changelog for every Mango 5.x release, from 5.0.0 through the latest 5.6.2, covering core platform changes, module updates, bug fixes, and security patches. |
| Mango v5 Highlights | Overview of the major features introduced in Mango 5.0, including PostgreSQL support, the Pi-Portfolio Manager (EMS), gRPC publisher, HTTPS by default, PKI services, and the redesigned UI. |
| Upgrade to v5 | Step-by-step instructions for upgrading from Mango 4.x to Mango 5.x, including Java requirements, license information, and browser cache considerations. |