Supabase Local Dev Stack

Supabase Local Dev Stack

The complete Supabase platform running locally. Postgres, Auth, Storage, Realtime, and Studio are all pre-configured and pre-seeded. Build and test your entire Supabase app without touching a cloud account.

What's Included

• Postgres 15 with the Supabase extensions pre-loaded (pgvector, pg_net, pgsodium, and more)
• GoTrue (Supabase Auth) — email/password and OAuth providers configurable via environment variables
• Supabase Storage — file uploads with policies enforced at the database level
• Realtime server — broadcast, presence, and Postgres changes via websockets
• Supabase Studio — full admin UI including Table Editor, SQL Editor, Auth management, and Storage browser
• Kong API Gateway — unified entry point mirroring the Supabase cloud API surface

Developer Experience

• JWT secret and anon/service role keys pre-generated and consistent across restarts
• Studio accessible at port 3000 with no login required in local mode
• All Supabase client SDKs work against this stack using http://localhost:8000 as the URL and the provided anon key
• Seed SQL file included — runs automatically on first Postgres initialization

What You Get

• docker-compose.yml — all six Supabase services wired together
• volumes/db/ — init SQL with extensions and seed data
• volumes/storage/ — local storage backend
• .env.example — JWT secret, keys, and service configuration
• README.md — Studio URL, API URL, anon key, and how to use the Supabase JS/Python/etc. SDKs against this stack

Service URLs

• Supabase Studio: http://localhost:3000
• API (Kong): http://localhost:8000
• Postgres: localhost:5432
• Auth (GoTrue): http://localhost:9999
• Realtime: ws://localhost:4000