Upgrade MAAS¶

This guide outlines the steps to upgrade MAAS to the latest version

General steps¶

Backup your system and database.
Verify Ubuntu release (lsb_release -a) and upgrade to the newer one if required.
Verify PostgreSQL version compatibility and upgrade it if required.
Upgrade rack nodes first, then region nodes.

sudo snap refresh maas --channel=<version>/stable

MAAS 3.7.4 and later: Controllers on different versions cannot communicate. Upgrade every region and rack controller in the same maintenance window. To put the upgraded deployment into FIPS mode afterwards, see Adopt FIPS mode on an existing deployment.
MAAS 3.6: PostgreSQL 14+ supported; PostgreSQL 16 recommended.
MAAS 3.5: Requires PostgreSQL 14.
MAAS 3.3: PostgreSQL 12 deprecated. Upgrade to 14 before proceeding.
MAAS 2.8 or earlier: Full backup required. Fresh install recommended if upgrade fails.

After upgrade:

sudo maas status # Verify services running