# 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: task image:agent (stamps this checkout's version) # 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 # This superuser is the dev database's admin: `task dev` runs archie-state-store # provision after first start to create the least-privilege roles the # mirroring deployments/dev.toml URLs name -- change them together. postgres: image: postgres:18 environment: POSTGRES_USER: archie POSTGRES_PASSWORD: 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 # The client port is published on every interface (agent containers reach # it over the bridge), so it defers every login to archied. Set NATS_TOKEN # (name it in [nats] token_env) and NATS_CALLOUT_ISSUER, the public key of # the account nkey seed named in [nats] callout_issuer_seed_env. command: ["-c", "/etc/nats/nats.conf"] environment: NATS_TOKEN: ${NATS_TOKEN:?NATS_TOKEN is required} NATS_CALLOUT_ISSUER: ${NATS_CALLOUT_ISSUER:?NATS_CALLOUT_ISSUER is required} ports: - "4222:4222" # client - "127.0.0.1:8222:8222" # monitoring (http://localhost:8222) volumes: - nats_data:/data - ./deployments/nats-callout.conf:/etc/nats/nats.conf:ro 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 # 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 # Stamped into the agent so the version it reports is the one the rest of # the install reports. `task image:agent` passes this checkout's version; # a bare `docker build` passes nothing and the agent answers dev. args: RUNTIME_VERSION: ${RUNTIME_VERSION:-dev} # A tag, not the digest: Compose refuses to build an image it is told to # name by digest. The digest a task container actually runs is pinned in # the daemon's own [containers] image, so nothing here decides it. See # deployments/systemd-user-service.md#6-pinning-the-archie-agent-image. image: git.catlow.cloud/sam/archie-agent:latest # ── 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