The HiveMQ Upgrade Guide provides information on how to upgrade from one HiveMQ version to another HiveMQ version and is an addendum to the HiveMQ User Guide.

HiveMQ uses semantic versioning for its version numbers.

Every HiveMQ version uses the following scheme:


Major versions are significant feature releases that add functionality that is not downward compatible with previous versions. Major versions require manual upgrade steps. Customers with professional support may be provided with tools for smooth migration. Major versions can change the extension framework and customers may need to upgrade previously-existing extensions to new APIs. Deprecated APIs can be removed in a major release. Clear documentation for the upgrade path is always provided.


Minor versions add features and functionality that is downward compatible with previous versions. Minor versions can adjust the extension framework and APIs. However, deprecated extension APIs stay in place and are not yet removed.


Patch versions (also known as bugfix releases) adjust functionality in a downward compatible manner and do not require any manual upgrade steps. These maintenance versions are drop-in replacements for the current minor version.

Hotfix Releases
Customers with professional support can receive hotfix releases that do not use semantic versioning. Hotfix releases are always customer specific and are usually downward compatible. If a hotfix version requires any manual upgrade steps, all customers who receive the hotfix version get detailed instructions.