From 42e1c22317c77e35e2710f01cd5a552b33b834a4 Mon Sep 17 00:00:00 2001 From: Charles Howard <96023061+charlesrhoward@users.noreply.github.com> Date: Thu, 15 Oct 2026 15:36:09 -0700 Subject: [PATCH] docs(self-hosting): document COMPOSE_PROFILES for the bundled postgres --- content/docs/self-hosting/environment-variables.mdx | 1 + content/docs/self-hosting/quickstart.mdx | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/content/docs/self-hosting/environment-variables.mdx b/content/docs/self-hosting/environment-variables.mdx index 3c09fc7..1011e34 100644 --- a/content/docs/self-hosting/environment-variables.mdx +++ b/content/docs/self-hosting/environment-variables.mdx @@ -160,6 +160,7 @@ Leave these unset to run without billing. Then grant access with the | Variable | Notes | | --- | --- | +| `COMPOSE_PROFILES` | `postgres` starts the bundled Postgres; `.env.example` sets it. Remove it when `DATABASE_URL` points at an external database. | | `MOGPLEX_VERSION` | Image tag to run, such as `v0.2.0`. Default `latest`. | | `MOGPLEX_IMAGE` | Image repository. Default `ghcr.io/mogplex/mogplex`; set it to use a mirror. | | `MOGPLEX_PORT` | Host port for the app. Default `3000`. | diff --git a/content/docs/self-hosting/quickstart.mdx b/content/docs/self-hosting/quickstart.mdx index 0cd96f1..c754f2f 100644 --- a/content/docs/self-hosting/quickstart.mdx +++ b/content/docs/self-hosting/quickstart.mdx @@ -87,7 +87,7 @@ Compose starts four services from that one image: | Service | What it does | | --- | --- | -| `postgres` | Postgres 17 with pgvector. Set `POSTGRES_PASSWORD` to change the default password. Set `DATABASE_URL` and `DATABASE_URL_UNPOOLED` to use an external database instead. | +| `postgres` | Postgres 17 with pgvector, started by `COMPOSE_PROFILES=postgres` from `.env.example`. Set `POSTGRES_PASSWORD` to change the default password. To use an external database instead, set `DATABASE_URL` and `DATABASE_URL_UNPOOLED` and remove `COMPOSE_PROFILES`; no local Postgres starts. | | `migrate` | Applies `neon/baseline.sql` and `neon/migrations/`, then exits. The app starts only after it succeeds. | | `app` | The web app on port 3000. Its health check calls `GET /api/health`. | | `cron` | Calls each cron route on its schedule with `Authorization: Bearer $CRON_SECRET`. |