Skip to main content

​
App will not start

Confirm .env includes BETTER_AUTH_SECRET, POSTGRES_URL, and at least one provider key.
Check that PostgreSQL is running and that POSTGRES_URL points at the right host, port, database, user, and password.
Run pnpm db:migrate after creating or changing the database.

​
Model calls fail

  • Verify the provider key is valid and not restricted to another project
  • Confirm the selected model belongs to the configured provider
  • Restart the app after editing .env
  • For local models, confirm the endpoint is reachable from the server runtime

​
MCP tools do not appear

Check the server command or URL first. Then confirm environment variables, authentication headers, and transport type. Use manual tool mode while testing.

​
Uploads fail

Confirm Supabase storage variables, bucket names, and service role permissions. The service role key must stay server-side and should not use a NEXT_PUBLIC_ prefix.