Supabase

Managed Postgres platform with auth, file storage, edge functions and realtime APIs.

Free tier

Two active projects, each with a 500 MB Postgres database; 5 GB egress and 1 GB file storage.

  • 2 active free projects across orgs you own or administer (paused projects don't count)
  • 500 MB database size per project
  • Shared CPU, 500 MB RAM
  • 5 GB egress
  • 5 GB cached egress
  • 1 GB file storage, 50 MB max file upload
  • 50,000 monthly active users
  • 500,000 Edge Function invocations
  • 2 million Realtime messages per month, 200 concurrent peak connections
  • 1-day API and database log retention
  • 1 GB log ingestion and 100 GB log query included

Gotchas

  • Projects are paused after 1 week of low database activity; a paused project can be restored from the dashboard for up to 1 year.
  • Direct connections use IPv6 unless the project has the IPv4 add-on; on IPv4-only networks use the Session pooler connection string.
  • No automatic backups or point-in-time recovery on Free.
  • Exceeding Free quotas triggers a notification and a grace period; continued overuse leads to service restrictions.

Setup

What you do

  1. Sign up at https://supabase.com/dashboard/sign-up (GitHub sign-in is fastest).
  2. Approve the browser prompt from npx supabase login, or create an access token at https://supabase.com/dashboard/account/tokens.
  3. For a direct database connection, copy the connection string from the project's Connect dialog.

How your agent gets access

Connection string

Get it at
supabase.com/dashboard/project/_?showConnect=true
Env var
DATABASE_URL

Replace [YOUR-PASSWORD] with the project's database password. Use the Session pooler string on IPv4-only networks.

CLI login

Install
npm install supabase --save-dev
Run
npx supabase login

Opens a browser by default; pass --token or set SUPABASE_ACCESS_TOKEN when headless.

API key

Get it at
supabase.com/dashboard/account/tokens
Env var
SUPABASE_ACCESS_TOKEN

Personal access token; lets CLI commands skip supabase login.

Check it worked

npx supabase projects list

Sources

Something out of date?