Troubleshooting

Common Issues

1. Port already in use:

   • Change the port mapping in docker-compose.yml: "3001:3000"

2. Database connection failed:

   • Ensure PostgreSQL service is healthy: docker-compose ps
   • Check database credentials in environment variables

3. Email not sending:

   • Verify SMTP credentials and settings
   • Check email service logs: docker-compose logs email
   • Ensure firewall allows outbound SMTP connections

4. Google OAuth not working:

   • Verify redirect URI matches exactly
   • Ensure Google Calendar API is enabled
   • Check client ID and secret are correct

Health Checks

The application includes health check endpoints:

• Server health: http://localhost:3000/health
• Check service status: docker-compose ps