The two compose comments contradicted each other on NOMAD_STORAGE_PATH (one
called it optional/"explicit", the other "MUST match") and neither warned about
the failure modes that actually break relocation. A user hit exactly this on
#1050: a case-mismatched path silently produced an empty Kiwix library.
- Frame the admin /app/storage host path as the single source of truth; the
admin auto-detects it (#938) and child apps follow, so no per-service edits.
- NOMAD_STORAGE_PATH is a fallback that should be kept in sync, not a hard
requirement (reconciles the contradiction).
- Add the real gotchas: move existing data first (keep zim/models subfolders),
paths are case-sensitive, and update the disk-collector volume too or host
disk stats point at the wrong place.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
cdf0532947