Troubleshooting
Common issues and how to resolve them.Health Checks
Check if services are running:Container Issues
Container Won’t Start
Check logs:- Missing environment variables
- Database connection failed
- Port already in use
Out of Memory
Increase container memory:Disk Full
Check disk usage:Database Issues
Connection Failed
-
Check PostgreSQL is running:
-
Check connection string:
-
Check PostgreSQL logs:
Migrations Failed
Database Full
Check size:Redis Issues
Connection Failed
Memory Full
Check memory:Network Issues
Services Can’t Communicate
Check Docker network:SSL Certificate Errors
-
Check certificate is valid:
- Ensure cert matches domain
- Check cert chain is complete
Performance Issues
Slow Queries
Enable query logging:High Memory Usage
Check process memory:High CPU
Check which service:Getting Help
If you’re still stuck:- Check GitHub Issues
- Search Discussions
- Join Discord
- Contact support (paid plans)
- Version number
- Error messages
- Relevant logs
- Steps to reproduce