# Supabase

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

- Category: [Databases](https://freetier.tech/c/database.md)
- Free tier: Always free. Two active projects, each with a 500 MB Postgres database; 5 GB egress and 1 GB file storage.
- Commercial use not stated
- Card requirement not stated
- Pricing: https://supabase.com/pricing
- Last verified: 2026-10-28

## Free tier limits

- 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 the human does

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 the agent gets access

#### Connection string

- Get it at: https://supabase.com/dashboard/project/_?showConnect=true
- Env var: `DATABASE_URL`
- Notes: 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`
- Notes: Opens a browser by default; pass --token or set SUPABASE_ACCESS_TOKEN when headless.

#### API key

- Get it at: https://supabase.com/dashboard/account/tokens
- Env var: `SUPABASE_ACCESS_TOKEN`
- Notes: Personal access token; lets CLI commands skip `supabase login`.

### Verify

```sh
npx supabase projects list
```

## Docs

- Quickstart: https://supabase.com/docs/guides/getting-started
- llms.txt: https://supabase.com/llms.txt

## Sources

- https://supabase.com/pricing
- https://supabase.com/pricing.md
- https://supabase.com/docs/guides/platform/billing-on-supabase
- https://supabase.com/docs/guides/platform/billing-faq
- https://supabase.com/docs/guides/platform/get-set-up-for-billing
- https://supabase.com/docs/guides/platform/free-project-pausing
- https://supabase.com/docs/guides/platform/manage-your-usage/logs-ingest
- https://supabase.com/docs/guides/platform/manage-your-usage/logs-query
- https://supabase.com/docs/guides/database/connecting-to-postgres
- https://supabase.com/docs/guides/local-development/cli/getting-started
- https://supabase.com/docs/reference/cli/supabase-login
- https://supabase.com/docs/guides/troubleshooting/email-password-login-disabled-supabase-vercel-marketplace-a7dd36
- https://supabase.com/terms
- https://supabase.com/llms.txt

JSON: https://freetier.tech/api/v1/services/supabase.json