# PostgreSQL for the State Store, optional external NATS, and the agent images # the daemon spawns per task. # # archied itself runs on the host under systemd, not here -- its chat tools # operate on host files, which a container cannot reach. See # deployments/systemd-user-service.md. # # Embedded NATS is the normal deployment and needs no Compose service. # State Store DB: docker compose up -d postgres # External broker: docker compose up -d nats # Build worker: docker compose build agent # Profile image: docker compose build agent-net # Stop external: docker compose down # Logs: journalctl --user -u archied -f (the daemon) # docker compose logs -f nats (the bus) services: # ── PostgreSQL (State Store) ─────────────────────────────────── # The standalone archie-state-store process's database. PostgreSQL 18 is # the required minimum and target; `postgres.Open` refuses anything older. # `task dev` brings this up before the State Store via dev:postgres. The # credentials and database name below are the dev default mirrored by # deployments/dev.toml's database_url -- change both together. postgres: image: postgres:18 environment: POSTGRES_USER: archie # archied setup generates PGPASSWORD into ~/.config/archie/env; the fallback is # the dev password deployments/dev.toml uses. POSTGRES_PASSWORD: ${PGPASSWORD:-archie} POSTGRES_DB: archie # postgres:18 moved its default PGDATA under a versioned path; pin the # classic location so the named volume keeps working across image updates. PGDATA: /var/lib/postgresql/data/pgdata ports: - "127.0.0.1:5432:5432" volumes: - pg_data:/var/lib/postgresql/data restart: unless-stopped healthcheck: test: ["CMD-SHELL", "pg_isready -U archie -d archie"] interval: 10s timeout: 5s retries: 5 # ── NATS JetStream ──────────────────────────────────────────────── nats: image: nats:2.14-alpine3.22 command: -js -m 8222 ports: - "4222:4222" # client - "8222:8222" # monitoring (http://localhost:8222) volumes: - nats_data:/data restart: unless-stopped healthcheck: test: ["CMD", "wget", "-q", "-O", "-", "http://localhost:8222/healthz"] interval: 10s timeout: 5s retries: 5 # ── agent image (built once, spawned per task by the daemon) ─────── # Not a long-running service: the daemon starts agent containers itself # via the Docker socket. This stanza exists only so the image can be # built locally. # # The build profile keeps `up -d` from starting it. Without it compose # creates a container that exits 0 immediately and still reports # "Started", which reads like a crash loop. Naming the service explicitly # still works without activating the profile: # # docker compose build agent (also: task docker-build) # docker compose pull agent -- plain `pull` skips profiled services # # Routine freshness is handled by the daemon, which pulls this image per # task: see containers.pull_policy in the config. Watchtower cannot do it # -- it only restarts long-running containers, and this is not one. agent: profiles: ["build"] build: context: . dockerfile: Dockerfile # Pinned to a verified digest -- archie-agent has no published semver # tag yet (CI only pushes :latest). See # deployments/systemd-user-service.md#pinning-the-archie-agent-image. image: ghcr.io/samcharles93/archie-agent@sha256:870f1b1357979cfea23fccacb24166ebeb9ab321708ef2c2b218a763ed99b090 # ── example agent profile image ───────────────────────────────────── # The agent image plus network lookup tools, for a workflow that names # `profile: network-investigator` (archipelago: workflows/firewall). # Build-only for the same reason as agent. It is local, so leave # containers.pull_policy at "missing": "always" would try to pull it. agent-net: profiles: ["build"] build: context: examples/profiles dockerfile: Dockerfile.agent-net image: archie-agent-net:local volumes: nats_data: pg_data: # The subnet is pinned for the optional external-broker profile because its # configured URL must be reachable from both the native daemon and workers. # Embedded mode discovers its selected bridge gateway at startup instead. networks: default: ipam: config: - subnet: 172.19.0.0/16