Docker

Container build and run for the API server.

Build

docker build -t swarm357-api .

The multi-stage Dockerfile installs techtide-swarm[supabase], copies config/ and templates/, and runs as a non-root swarm user.

Run locally

docker run --rm -p 8000:8000 \
  -e SWARM_API_KEY=dev \
  -e SWARM_REQUIRE_AUTH=1 \
  swarm357-api

Health check

The image defines a HEALTHCHECK against /api/health. Railway and other platforms should use the same probe.

Environment

VariablePurpose
PORTHTTP port (default 8000)
SWARM_CONFIG_PATHRoster YAML path
SWARM_SERVER_MODEDisables destructive local tools
SWARM_CHECKPOINT_DIRWritable checkpoint directory
PreviousOperations layerNext Railway