-
Notifications
You must be signed in to change notification settings - Fork 0
Upgrade‐Guide
This guide outlines the step-by-step instructions for upgrading your Die Management System (DMS) deployment to v1.6.0.
Important
Backup Notice: This release introduces the distributable Docker image model and optimizes database connection handling. Please back up your PostgreSQL database using the ./dms-backup.sh backup tool before performing any upgrade tasks.
Beginning with v1.6.0, you no longer need to clone the source code on your production host. You can deploy and upgrade using pre-built images fetched directly from GitHub Container Registry (GHCR).
Navigate to your deployment directory (e.g., dms) and download the updated compose file:
curl -LO https://raw.githubusercontent.com/sauryah/dms-o2/main/docker-compose.ghcr.ymlEnsure your .env contains all required variables defined in the latest .env.example.
To pin your deployment to v1.6.0, add the following line to your .env file:
DMS_VERSION=1.6.0If you are running the source-built container stack, stop it first:
docker compose downLaunch the new stack. Database migrations will run automatically on startup:
docker compose -f docker-compose.ghcr.yml up -dIf your deployment relies on building images from source code, follow this standard Git-based workflow:
git fetch --tags
git checkout tags/v1.6.0Run the Django migrations to update database indices and cache schemas:
docker compose exec django python manage.py migrateRebuild the container configurations to incorporate frontend bundle updates and Go search API optimization:
docker compose down
docker compose up -d --buildVerify that your upgraded container stack is fully operational:
docker compose -f docker-compose.ghcr.yml psdocker compose -f docker-compose.ghcr.yml exec django python manage.py sync_search