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.

Snap

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

Debian package (PPA)

sudo apt-add-repository ppa:maas/<version>
sudo apt update && sudo apt upgrade maas

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