Before upgrading, run a full backup following the Backup Guide.
- Windows:
.\atlas-backup.ps1 backup - Linux:
./atlas-backup.sh backup
Download these files from the official repository and place them in your Atlas CMMS directory (next to your .env file):
- docker-compose.yml — Download latest
- nginx.conf — Download latest
Compare your current .env against the latest .env.example. Optionally, add any new variables you might need that are missing in your .env.
Also check the README for documentation on new environment variables.
docker compose pull
docker compose up -d- Stop the stack:
docker compose down
- Restore from the backup you created in step 1 (see Backup Guide).
- Re-pull the previous version's images and restart.
Tip: To upgrade to a specific version instead of latest, download the config files from the release tag you want (e.g. https://github.com/Grashjs/cmms/blob/v1.8.0/docker-compose.yml) and pin the image tags in your docker-compose.yml accordingly.