ProgressionMods/deploy/README.md

Progression deployment

This deployment pulls the published container from the Gitea registry. No repository checkout or local image build is required on the server.

1. Copy .env.example to .env and change PROGRESSION_ADMIN_TOKEN.
2. Set PROGRESSION_EXTERNAL_PORT if port 8000 is already in use.
3. Start the service:

docker compose pull
docker compose up -d

The SQLite database and Steam Workshop files are stored in named Docker volumes and survive image upgrades. To update later, run the same two commands again.

On a new deployment, the hourly refresh timer stays paused while the first full Workshop download runs. Its hard limit defaults to 12 hours and can be changed with INITIAL_DOWNLOAD_TIMEOUT_SECONDS. Follow the per-mod title, Workshop ID, result, and completion percentage in Dockhand or with docker compose logs -f. Failed batches also include SteamCMD's output tail so network, subscription, and filesystem errors are visible directly in the container log.

The image does not switch Unix users at startup because some rootless and capability-restricted container hosts block setuid. The process remains inside the container's user namespace and writes directly to its named volumes.