Troubleshooting
Solutions to common Penombre issues.
Startup
Authentication
Email & SMTP
File storage
Networking & reverse proxy
Debugging
Enable verbose logging to diagnose issues:
LOG_LEVEL=debug
LOG_FORMAT=jsonView live logs:
docker compose logs -f appLog format json produces structured output that's easier to filter with
tools like jq. Use console for human-readable output during
development.
Check the database directly:
docker compose exec db psql -U postgres -d penombre -c "\dt"Check the health endpoint:
curl http://localhost:3000/api/healthFound an issue or want to contribute? Edit this page on GitHub