Before
- Read the release notes for the versions between yours and the target. They list the upgrade steps and any ordering constraints.
- Take a backup. See Backups.
- Check disk and memory headroom; upgrade steps that migrate data need free space.
Steps
- Pull the new deployment files.
- Run the migration steps listed in the release notes, in the order given. Where a step asks for services to be stopped first, follow it exactly.
- Rebuild and restart:
docker compose up -d --build. - Verify:
docker compose ps, the health check, and Settings › System shows the new version.
Agents
Agent upgrades are separate and roll out through fleet groups and channels. See Updates.
Rollback
Restore the pre-upgrade backup and redeploy the previous version. The release notes mark every step that needs a restore to reverse.