Skip to content

docker-compose.md

Latest commit

 

History

History
75 lines (57 loc) · 3.46 KB

docker-compose.md

File metadata and controls

75 lines (57 loc) · 3.46 KB
Raw

Docker Compose quickstart

This is the supported self-host install path. End-to-end clock time on a fresh Ubuntu 24.04 VPS with Docker preinstalled: ≤5 minutes from clone to login screen.

Prerequisites

  • Linux host with ≥4 GB RAM and ≥20 GB free disk.
  • Docker Engine 27+ with docker compose v2.
  • A DNS A-record pointing at the host (Traefik provisions Let's Encrypt automatically).
  • Outbound HTTPS to your image registry (Amazon ECR — see the image and version policy) and Let's Encrypt (acme-v02.api.letsencrypt.org).

Five-minute install

  1. Clone the repo at the version tag you want to install:

    git clone --depth 1 --branch v0.1.0 https://github.com/Seta-International/agent-platform.git seta && cd seta

  2. Copy the env template and edit the required values:

    cp .env.example .env
chmod 600 .env
$EDITOR .env

    Required edits (see configuration.md for the full list): PLATFORM_DOMAIN, PLATFORM_ACME_EMAIL, POSTGRES_PASSWORD, BETTER_AUTH_SECRET. For first-try local installs, leave PLATFORM_TLS_MODE=self-signed and PLATFORM_DOMAIN=localhost.

  3. Pull and start the stack:

    docker compose pull
docker compose up -d

  4. Run database migrations (one-shot container, exits when done):

    docker compose run --rm migrator

  5. (Optional, for demo data) Seed:

    docker compose run --rm seeder

    seeder is a dedicated one-shot service behind the seed profile; docker compose run auto-enables the profile of the named service, so up -d (no args) skips it.

  6. Open https://${PLATFORM_DOMAIN} and log in with the bootstrap credentials printed to the server logs:

    docker compose logs server | grep -i 'bootstrap'

What got installed

Service Image Role
proxy traefik:v3.1 Reverse proxy, Let's Encrypt or self-signed TLS, port 443.
web ${PLATFORM_IMAGE_WEB} Static React bundle, served by proxy.
server ${PLATFORM_IMAGE_SERVER} API + workers, default PLATFORM_MODULES=*.
migrator ${PLATFORM_IMAGE_SERVER} One-shot platform-server migrate. depends_on: postgres healthy.
postgres pgvector/pgvector:pg17-trixie Persistent named volume.

Verifying the install

  • docker compose ps — all services running/healthy; migrator exited (0).
  • curl -sfk https://${PLATFORM_DOMAIN}/health/live — the API liveness probe, returns { "ok": true }. (-k for self-signed.) (/healthz is the web container's nginx static endpoint returning ok, not the API.)
  • Log in with the bootstrap user from step 6 above.

Common first-install issues

  • Let's Encrypt rate-limited. Cause: testing repeatedly against the same domain. Fix: temporarily set PLATFORM_TLS_MODE=self-signed in .env, restart proxy.
  • Postgres pull is slow. Pre-pull: docker pull pgvector/pgvector:pg17-trixie.
  • Bootstrap credentials not in logs. migrator must succeed before first server start. Rerun docker compose run --rm migrator, then docker compose restart server.
  • Permission denied binding to :443. Run Docker as root, or use rootless Docker with cap_add: NET_BIND_SERVICE.
  • POSTGRES_PASSWORD and BETTER_AUTH_SECRET are required and empty by default. The compose stack will refuse to start until you set them.

Next steps