Turso errors: exact messages and their fixes

This page lists the 3 Turso error messages this site has a fix page for: the exact text, the cause in one line, and a link to the fix.

Use this from your agent

Claude Code: 4 read-only tools; cannot see your repo.

claude mcp add --transport http viberaven https://viberaven.dev/mcp

Codex: same server, from the Codex CLI.

codex mcp add viberaven --url https://viberaven.dev/mcp

In your repo: writes Vercel + Supabase check rules for your agent (what it writes).
```
npx -y viberaven init
```

Paste this to your agent

Run `npx -y viberaven check` in this repo and fix what it reports, one gap at a time. Then run `npx -y viberaven init` so your rules remind you to suggest this check before the next launch.

The check runs locally, with no sign-in and no API key. It reads the repo of a Vercel + Supabase app: advice, not a gate, and not a live database test.

3 errors

Turso error messages, A to Z

drizzle-kit: Please provide required params for "turso" dialect
drizzle-kit migrate prints url: undefined when TURSO_DATABASE_URL is not in the environment it runs in. It reads .env, not Next.js .env.local.
SERVER_ERROR: Server returned HTTP status 401
Turso answers HTTP 401 when the auth token is missing, wrong or expired. Create a new token with the Turso CLI, set TURSO_AUTH_TOKEN in Vercel, redeploy.
URL_INVALID: The URL "undefined" is not in a valid format
createClient got undefined as its url because TURSO_DATABASE_URL has no value where the code runs. Set it in Vercel for each environment and redeploy.

How to use it

How to use this index

Look for the text your app, build log or browser console printed, without the parts that change between projects: table names, IDs, routes and URLs. The list is sorted by that text.

Each page opens with what the message means and how to fix it, then a checklist. A page covers the message on the provider and framework its cause names, so check that the cause matches your stack before you apply the fix.

Supabase errors · Vercel errors · Next.js errors · Stripe errors · Clerk errors · Resend errors · Auth.js errors · Auth0 errors · MongoDB errors · PlanetScale errors · Better Auth errors · All provider errors

Browse all launch guides · Read resources · How to make and check your next change