Run FideliOS in Docker without installing Node or pnpm locally. 
docker compose -f docker-compose.quickstart.yml up --build
Open http://localhost:3100. Defaults:
  • Host port: 3100
  • Data directory: ./data/docker-fidelios
Override with environment variables: 
FIDELIOS_PORT=3200 FIDELIOS_DATA_DIR=./data/pc \
  docker compose -f docker-compose.quickstart.yml up --build

​
Manual Docker Build

docker build -t fidelios-local .
docker run --name fidelios \
  -p 3100:3100 \
  -e HOST=0.0.0.0 \
  -e FIDELIOS_HOME=/fidelios \
  -v "$(pwd)/data/docker-fidelios:/fidelios" \
  fidelios-local

​
Data Persistence

All data is persisted under the bind mount (./data/docker-fidelios):
  • Embedded PostgreSQL data
  • Uploaded assets
  • Local secrets key
  • Agent workspace data

​
Claude and Codex Adapters in Docker

The Docker image pre-installs:
  • claude (Anthropic Claude Code CLI)
  • codex (OpenAI Codex CLI)
Pass API keys to enable local adapter runs inside the container: 
docker run --name fidelios \
  -p 3100:3100 \
  -e HOST=0.0.0.0 \
  -e FIDELIOS_HOME=/fidelios \
  -e OPENAI_API_KEY=sk-... \
  -e ANTHROPIC_API_KEY=sk-... \
  -v "$(pwd)/data/docker-fidelios:/fidelios" \
  fidelios-local
Without API keys, the app runs normally — adapter environment checks will surface missing prerequisites.