feat: better first time downloading, feat: more logging

deploy/.env.example

@@ -20,4 +20,6 @@ STEAMCMD_BATCH_SIZE=25
 STEAMCMD_TIMEOUT_SECONDS=1800
 REFRESH_INTERVAL_SECONDS=3600
 REFRESH_ON_STARTUP=true
+# Hard ceiling for the first full Workshop download (12 hours).
+INITIAL_DOWNLOAD_TIMEOUT_SECONDS=43200
 

deploy/README.md

@@ -15,3 +15,8 @@ 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`.
+

deploy/compose.yaml

@@ -23,6 +23,7 @@ services:
       STEAMCMD_TIMEOUT_SECONDS: ${STEAMCMD_TIMEOUT_SECONDS:-1800}
       REFRESH_INTERVAL_SECONDS: ${REFRESH_INTERVAL_SECONDS:-3600}
       REFRESH_ON_STARTUP: ${REFRESH_ON_STARTUP:-true}
+      INITIAL_DOWNLOAD_TIMEOUT_SECONDS: ${INITIAL_DOWNLOAD_TIMEOUT_SECONDS:-43200}
     volumes:
       - progression-data:/srv/progression/.data
       - progression-workshop:/opt/steamcmd/steamapps