Delphidelphi

Docker Setup

Running Delphi in a Docker container.

Start the container

docker compose up -d

Critical: the ~/.claude volume mount

Delphi authenticates via the Claude CLI (~/.claude/.credentials.json). The docker-compose.yml mounts your local ~/.claude directory into the container. Without this mount, the CLI cannot authenticate and the bot will not start.

Do not remove the ~/.claude volume mount from docker-compose.yml. The bot will fail to start without Claude CLI credentials.

View logs

docker compose logs -f main

Stop

docker compose down

Rebuild after code changes

docker compose up -d --build

Environment variables

All .env variables work the same in Docker. The docker-compose.yml loads .env automatically via env_file: .env.

Volumes

The compose file creates two volumes:

MountPurpose
~/.claude:/root/.claudeClaude CLI credentials (required)
./data:/app/dataSQLite database persistence
./logs:/app/logsLog file persistence
./agents:/app/agentsSkills, memory, config