This repository provides a pre-configured Docker Compose setup for Supabase, allowing developers to quickly deploy a full Supabase stack locally with minimal configuration. The default settings enable immediate use of all Supabase features (auth, database, storage, functions) without needing to manually configure each component.
Supabase is a powerful, open-source backend platform that simplifies the development of modern web and mobile applications. It offers a wide range of features such as authentication, real-time database, storage, and edge functions, all in a single package.
To quickly install Supabase using Docker Compose, run:
curl -s https://raw.githubusercontent.com/minhng92/supabase-docker-compose/master/run.sh | bash -s my-supabaseReplace my-supabase with your desired destination folder.
Then open Supabase Studio at http://localhost:8000 and log in with the following credentials:
- Username: supabase
- Password: minhng.info (default password)
This repository maintains snapshots of previous versions in the checkpoints directory. As the repository undergoes periodic updates, these historical checkpoints provide access to earlier configurations and component versions for reference or compatibility purposes.
| Checkpoint | supabase/studio | kong | supabase/gotrue | postgrest/postgrest | supabase/realtime | supabase/storage-api | darthsim/imgproxy | supabase/postgres-meta | supabase/edge-runtime | supabase/logflare | supabase/postgres | timberio/vector | supabase/supavisor |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2026-04-09 (current) | 2026.04.08-sha-205cbe7 | 3.9.1 | v2.186.0 | v14.8 | v2.76.5 | v1.48.26 | v3.30.1 | v0.96.3 | v1.71.2 | 1.36.1 | 15.8.1.085 | 0.53.0-alpine | 2.7.4 |
| 2026-03-14 | 2026.02.16-sha-26c615c | 2.8.1 | v2.186.0 | v14.5 | v2.76.5 | v1.37.8 | v3.30.1 | v0.95.2 | v1.70.3 | 1.31.2 | 15.8.1.085 | 0.53.0-alpine | 2.7.4 |
| 2026-01-25 | 2025.12.17-sha-43f4f7f | 2.8.1 | v2.184.0 | v14.1 | v2.68.0 | v1.33.0 | v3.30.1 | v0.95.1 | v1.69.28 | 1.27.0 | 15.8.1.085 | 0.28.1-alpine | 2.7.4 |
| 2025-10-01 | 2025.09.29-sha-626eb30 | 2.8.1 | v2.180.0 | v13.0.7 | v2.34.40 | v1.28.0 | v3.8.0 | v0.91.6 | v1.69.12 | 1.22.4 | 17.6.1.011 | 0.28.1-alpine | 2.7.0 |
| 2025-03-22 | 20250224-d10db0f | 2.8.1 | v2.170.0 | v12.2.8 | v2.34.40 | v1.19.3 | v3.8.0 | v0.86.1 | v1.67.2 | 1.12.5 | 15.8.1.049 | 0.28.1-alpine | 2.4.12 |
Supabase provides several API endpoints that are accessible at localhost:8000:
- REST API: http://localhost:8000/rest/v1/
- Authentication: http://localhost:8000/auth/v1/
- Storage: http://localhost:8000/storage/v1/
- Realtime: http://localhost:8000/realtime/v1/
- Edge Functions: http://localhost:8000/functions/v1/[function-name]
To create a new edge function:
- Place your TypeScript code in
volumes/functions/[function-name]/index.ts - Apply changes by restarting only the functions service:
docker compose restart functions --no-deps
Supabase requires proper environment configuration to function correctly. This section covers how to set up your environment variables and configuration files for both development and production deployments. Proper environment setup ensures security, performance, and compatibility across different hosting scenarios.
For testing or local development, run the following command in your project directory:
chmod +x ./volumes/api/kong-entrypoint.sh # avoid permission denied
docker compose up -dThis will start all Supabase services in detached mode.
Before deploying to production:
- Make a copy of the sample .env file if you haven't already
- Edit the .env file to replace all default "minhng.info" values with your own domain and credentials
- Configure secure passwords, API keys, and JWT secrets
- Set appropriate environment-specific variables for scaling and performance
Never use the default credentials in a production environment as this poses significant security risks.
