Database and AI

The app can't connect to the database

What you see
Errors mention the database, DATABASE_URL or a connection timeout.
Why it happens
The connection setting is missing, wrong for this environment, or the database branch doesn't exist.
How to fix it
  1. Ask your agent to check DATABASE_URL is set (names only) in this environment.
  2. For your computer, it pulls a development branch's settings with vercel env pull, never production's.

Message for your agent

My app can't connect to the database. Check DATABASE_URL is set for this environment (don't show it), confirm we use a development branch locally, and read the error to find the cause.

Tip

How to prevent it: Never point your computer at the production database.

Still stuck?Report it to your agent, clearly

Hands-on test on Mac and Windows pending · Last reviewed Nov 8, 2026