Docs / Configuration

On this page · 1 sections
Contents

PLANNED

Docker imageAPI referenceMigrating from Supabase

Docs / GET STARTED / Configuration

Configuration

MEGABASE_HOST, MEGABASE_PORT, DATABASE_URL, JWT_SECRET — what each variable does.

docs/configuration.md · Built from commit a1a6d87 · 2026-10-09 · Edit on GitHub ↗

The megabase binary reads the process environment at startup. Do not invent other names. There is no .env.example in this tree; the judge uses vendor/supabase/docker/.env.example only.

VariableDescription
MEGABASE_HOSTBind address. Default 0.0.0.0.
MEGABASE_PORTHTTP port. Default 8000.
DATABASE_URLPostgreSQL connection string. PostgreSQL stays external; Megabase does not bundle it. Read today, unused until a unit needs it.
JWT_SECRETSecret for signing and verifying JWTs. Auth is not implemented; the value is optional and unused so far.

Listen address

Liveness: GET /_megabase/health (not a Supabase path).

Same URL layout as the Supabase gateway (ADR 0002):

  • /rest/v1
  • /auth/v1
  • /storage/v1
  • /realtime/v1
  • /functions/v1
  • /pg (Postgres Meta)

Until a unit passes the judge, each of those answers HTTP 501 with code: MEGABASE_NOT_IMPLEMENTED.

How to build or run the container image is in Install.

Wrong or unfinished? Open an issue or edit docs/configuration.md on GitHub.