Upgrading

The diskless model makes upgrades safe: the broker is near-stateless, the data lives in storage — acknowledged writes are not lost across a restart.

# 1. get the new image (the tag from the “Releases” section):
docker login pkg.sourcecraft.tech -u iam
docker pull <image>:<new-tag>

# 2. update the tag in docker-compose.yml / .env and restart:
docker compose up -d roxa roxa-admin

Enterprise: the maintenance window

The license permits running builds whose build date is not newer than the paid maintenance window. Before upgrading, make sure the window covers the new release (the “License” card in the web console or roxa license show <token>), otherwise renew maintenance. The current version keeps working without restrictions — see Licensing.

In an air-gapped perimeter the procedure is the same with an offline tarball (docker load), see getting the image.

The list of versions and changes is in Releases.