Adding the fix for the config ..

.env.example

@@ -8,9 +8,19 @@ SESSION_SECRET=change-me-to-a-random-string
 
 # Admin password hash (argon2). Generate with:
 #   python -c "from passlib.hash import argon2; print(argon2.hash('mysecret'))"
-# If unset and no admin stored in Redis, the app shows a first-run setup page.
+# If unset and no admin stored in Redis, the app shows a first-run setup page
+# (recommended — the wizard stores the hash in Redis and avoids the $-escaping trap below).
 ADMIN_USERNAME=admin
 # ADMIN_PASSWORD_HASH=
+#
+# IMPORTANT: argon2 hashes start with `$argon2id$v=19$m=...` and contain many `$`
+# characters. Docker Compose interprets `$word` as variable substitution, so pasting
+# a raw hash here will produce warnings like
+#   WARN The "argon2id" variable is not set. Defaulting to a blank string.
+# and the container will receive a mangled hash (and you will not be able to log in).
+# Quoting (single or double) does NOT escape `$` in .env — you must double every `$`:
+#   ADMIN_PASSWORD_HASH=$$argon2id$$v=19$$m=65536,t=3,p=4$$<salt>$$<hash>
+# Or just leave this unset and use the /setup wizard on first boot.
 
 # --- Redis ---
 REDIS_URL=redis://redis:6379/0