# 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