On this page
Version compatibility
Last updated on
11 November 2025
To which version should I upgrade?
If you are upgrading from versions prior to the 3.x or 4.x, the table below describes the version upgrades compatibility and potential issues to avoid:
Matrix of compatibility
| Version | Came from | Upgrade path |
| 4.0.x | 2.0.x | 2.0.x update to 4.0.x |
| 3.0.x | 8.x-1.x | 8.x-1.x update to 3.0.x |
Upgrade Guidance
- If you are on 2.0.x: Upgrade to 4.0.x
- If you are on 8.x-1.x: Upgrade to 3.0.x
- If you are on 3.0.x, you can upgrade to 4.0.x if you wish
Warning
- đź”´ Do not upgrade from 2.0.x to 3.0.x.
- 3.0.x is based on 8.x-1.x, so updating from 2.0.x cause downgrade.
- For more information see: #3468976: Untangle branch confusion and document missing features in 3.x
Help improve this page
Page status: No known problems
You can:
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion