Troubleshooting

Common failure modes and checks.

App unhealthy

  • Check docker compose ps and app logs
  • Confirm Postgres/Redis health
  • Hit /api/health and /api/ready

Login loops

Clear site data, confirm system clock sync, and verify JWT secrets were not rotated unexpectedly.

PDF font issues

Ensure assets/fonts Geist files are present in the runtime image trace.