Upgrade to Carbonio 25.9.0#
This section contains the manual upgrade procedures to the latest Carbonio release, from the latest 25.3.0 and from older versions, the changelogs of recent and older releases, and any security advice, if present.
Carbonio does not have any installer: whenever new versions are released, the Zextras repositories are updated and packages are available for installation along with the other system updates. Therefore, the Carbonio upgrade procedure is carried out along with the system upgrade.
The upgrade procedure can be carried out manually or using Ansible. The latter procedure works even if you installed Carbonio manually, provided you fill in the inventory file.
In both cases, the procedure will upgrade any version of Carbonio to the latest available at the moment you start the procedure. In other words, the starting version is not important: upgrading from 24.12, 24.9 or 24.7 will bring Carbonio to the latest version of Carbonio (at the time of writing, 25.9.0).
Before starting an upgrade procedure, it is strongly suggested to make a snapshot of the Nodes and a backup of the data.
Operating System Upgrade#
In case you need to upgrade the OS, you must update Carbonio and all repositories in a specific order to ensure compatibility and avoid package dependency errors.
Follow this sequence:
Upgrade Carbonio to the latest available version for your current OS release
Upgrade the operating system and update its repositories
Perform the OS upgrade (for example, from Ubuntu 22.04 to 24.04 or from RHEL 8 to 9), then update all system packages to the latest versions
Update the PostgreSQL and Carbonio repositories to match the new OS version. This step ensures the repositories point to the correct package sources after the OS upgrade.
Upgrade the Carbonio packages again using the new repositories. This final upgrade aligns all Carbonio components with the updated OS environment.