Skip to main content

T5. Database not connecting

What this page helps you do

Work through the most common database connection problems.

Why it matters

Database failures can make the app look partly alive while the real product is unusable.

You should already have

  • a database-backed app

Skip this page if

  • the app does not use a database

What to do

  • check the connection URL
  • check network access rules
  • check SSL requirements and credentials

Re-check the exact production database URL before deeper debugging.

Common mistakes

  • using local credentials in production
  • forgetting provider-specific SSL requirements
  • not knowing which database instance the app is hitting

Next step

Go to F5. Database basics.

Advanced notes

TODO for contributors: add a short checklist for common hosted Postgres and MySQL connection issues.