The reference's concepts, runtime descriptions, and commands are derived from the supabase/evals README, which is Apache-2.0. Add an attribution section to references/agent-evals.md with the license link and list the harness repository in references/source-index.md, per the repository's attribution convention. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
4.2 KiB
Source index
Research checked: 2026-07-16.
Use current official documentation and source before making version-sensitive claims. Supabase services are released independently, while the self-hosted Docker directory pins a tested combination.
Primary documentation
Canonical source repositories
- Main repository and official Docker stack: https://github.com/supabase/supabase/tree/master/docker
- Supabase CLI: https://github.com/supabase/cli
- Auth: https://github.com/supabase/auth
- Realtime: https://github.com/supabase/realtime
- Storage: https://github.com/supabase/storage
- Edge Runtime: https://github.com/supabase/edge-runtime
- Supavisor: https://github.com/supabase/supavisor
- Supabase Postgres: https://github.com/supabase/postgres
- PostgREST: https://github.com/PostgREST/postgrest
- Agent evals harness: https://github.com/supabase/evals (Apache-2.0; concepts/commands checked 2026-08-09)
Within the official Docker directory, read README.md, CONFIG.md, CHANGELOG.md, versions.md, .env.example, docker-compose.yml, run.sh, and the relevant tests/ file together. CONFIG.md explicitly distinguishes source-derived facts from interpretive descriptions; use each service's own documentation or source when intent matters.
Freshness rules
- Prefer current source and dated changelog entries over older prose examples.
- Treat exact image tags, CLI flags, environment variables, routes, defaults, and platform parity as version-sensitive.
- Do not assume the CLI local stack and self-hosted Compose stack run identical versions or expose identical management features.
- When official pages disagree, reconcile against the current Docker Compose file, Docker changelog, and service source. For example, an older restore page may mention Postgres 15 while the current Docker release and upgrade guide establish Postgres 17 as the default.
- Record the source URL and access date for operational decisions that will outlive the session.
Live validation performed
The skill was refined against the official self-hosted Docker configuration from the supabase/supabase default branch at commit ae957414b46527249c22bd9b81f0338bd0956a05 and the stable Supabase CLI 2.109.1 available on 2026-07-16. Validation covered configuration resolution, Linux Docker deployment, service health, the official 35-check end-to-end self-hosted smoke suite, and the current CLI command/help surface. This is execution evidence for that release set, not a guarantee for future images or every infrastructure topology.