Troubleshooting
Container Will Not Start
Interpret entrypoint, migration, storage and health-check failures.
docker compose ps -a
docker compose logs --tail=300 kaya
docker inspect kaya --format '{{json .State}}'
Look for failure before or after Running database migrations. Permission errors usually concern bind-mounted data//uploads/; database errors may concern SQLite integrity or a failed migration; missing .runtime.env on an existing encrypted database is a recovery issue, not a cue to generate a new key.
Check free space and host ownership:
df -h
ls -la data uploads
If the image starts only with a fresh directory, preserve the original unchanged and follow Database Problems or Restoring Kaya.