Skip to main content

Self-Hosting Troubleshooting

Troubleshooting

502 Bad Gateway

  • Cause: Nginx on the host cannot reach the Docker containers.
  • Fix: Check if containers are running with docker compose ps. Look at backend logs with docker compose logs api and check ports mapping.

Database Connection Refused

  • Cause: Wrong credentials in your backend .env or the database container is still starting up.
  • Fix: Verify DB_HOST, DB_USERNAME, and DB_PASSWORD in .env. Check database logs with docker compose logs db.

WebSockets Disconnect / Not Connecting

  • Cause: Key mismatch, or Nginx WebSocket upgrade headers are missing.
  • Fix: Verify VITE_REVERB_APP_KEY on the frontend matches REVERB_APP_KEY on the backend. Ensure Nginx configuration includes the Upgrade and Connection headers.