chore: initial commit - Supabase stack with local Docker configuration

2026-01-28 15:21:06 +08:00
commit 6af0989fe7
32 changed files with 2342 additions and 0 deletions
@@ -0,0 +1,89 @@
+# Infra
+
+Local Docker environment for Supabase stack and supporting services.
+
+## Quick Start
+
+1. Copy environment file:
+   ```bash
+   cp infra/env/.env.example infra/env/.env.local
+   ```
+
+2. Update `infra/env/.env.local` with your secrets and configurations.  
+   **Important**: Ensure all required fields are filled (no `CHANGE_ME` values).
+
+3. Start services:
+   ```bash
+   docker compose --env-file infra/env/.env.local -f infra/local/docker-compose.yml up -d
+   ```
+
+## Access
+
+- **Supabase Studio**: http://localhost:8001  
+  Credentials from `DASHBOARD_USERNAME` and `DASHBOARD_PASSWORD` in `.env.local`
+- **Qdrant**: http://localhost:6333
+- **Redis**: localhost:6379
+
+## Troubleshooting
+
+### Port Conflicts
+
+If `localhost:8001` is unreachable, check for port conflicts:
+
+**Linux/WSL:**
+```bash
+ss -ltnp 'sport = :8001'
+```
+
+**Windows:**
+```powershell
+Get-NetTCPConnection -LocalPort 8001 | Select-Object LocalAddress, LocalPort, State, OwningProcess
+Get-Process -Id (Get-NetTCPConnection -LocalPort 8001).OwningProcess
+```
+
+If a Windows service occupies the port, either:
+- Stop the conflicting service
+- Change `KONG_HTTP_PORT`, `API_EXTERNAL_URL`, and `SUPABASE_PUBLIC_URL` in `.env.local`
+
+### Environment Variables Not Applied
+
+If Docker reports warnings about missing variables, verify:
+- The `--env-file` path is correct
+- All required variables are set in `.env.local` (no empty values)
+
+### Service Health
+
+Check service status:
+```bash
+docker compose --env-file infra/env/.env.local -f infra/local/docker-compose.yml ps
+```
+
+View logs:
+```bash
+docker compose --env-file infra/env/.env.local -f infra/local/docker-compose.yml logs <service-name>
+```
+
+## Services
+
+| Service     | Description                           |
+|------------|---------------------------------------|
+| kong       | API gateway (8001/8443)             |
+| studio     | Supabase UI (via Kong)               |
+| auth       | Authentication (GoTrue)              |
+| db         | PostgreSQL database                    |
+| rest       | PostgREST API                         |
+| realtime   | Realtime subscriptions                 |
+| storage    | Storage API                           |
+| functions  | Edge functions                        |
+| analytics  | Logflare logging                      |
+| vector     | Log aggregator                        |
+| supavisor  | Database connection pooler             |
+| qdrant     | Vector database                        |
+| redis      | Cache/message broker                   |
+
+## Important Notes
+
+- Never commit `.env.local` to version control
+- Always use `--env-file` when running docker compose
+- Port conflicts on Windows (especially 8000) can prevent Kong from starting
+- Kong configuration is auto-generated from templates on container start