Skip to main content

​
Quick Start

docker run -d \
  --name argentos \
  -p 18789:18789 \
  -p 8080:8080 \
  -v ~/.argentos:/root/.argentos \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  ghcr.io/argentaios/argentos:latest
The container runs the gateway on port 18789 and the dashboard on port 8080.

​
Docker Compose

version: "3.8"
services:
  argentos:
    image: ghcr.io/argentaios/argentos:latest
    restart: unless-stopped
    ports:
      - "18789:18789"
      - "8080:8080"
    volumes:
      - argentos-state:/root/.argentos
      - argentos-workspace:/root/argent
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}

volumes:
  argentos-state:
  argentos-workspace:

​
Building from Source

git clone https://github.com/ArgentAIOS/argentos.git
cd argentos
docker build -t argentos .
The Dockerfile uses node:22-bookworm, installs Bun for build scripts, and runs the gateway as a non-root user for security.

​
LAN Access

By default the container binds to loopback. To expose the gateway on LAN (for mobile apps or external health checks):
1

Set an authentication token

Set ARGENT_GATEWAY_TOKEN or ARGENT_GATEWAY_PASSWORD environment variable.
2

Override the CMD

docker run -d \
  --name argentos \
  -p 18789:18789 \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -e ARGENT_GATEWAY_TOKEN=your-secret-token \
  ghcr.io/argentaios/argentos:latest \
  node dist/index.js gateway --allow-unconfigured --bind lan

​
Environment Variables

VariableRequiredDescription
ANTHROPIC_API_KEYYesAnthropic API key for the agent
ARGENT_GATEWAY_TOKENNoToken for gateway authentication (required for LAN)
ARGENT_GATEWAY_PASSWORDNoPassword alternative to token
ARGENT_DOCKER_APT_PACKAGESNoExtra apt packages to install at build time