Docker

Run AImetier in Docker without installing Node or pnpm locally.

Compose Quickstart (Recommended)

docker compose -f docker/docker-compose.quickstart.yml up --build

Open http://localhost:3100.

Defaults:

• Host port: 3100
• Data directory: ./data/docker-aimetier

Override with environment variables:

AIMETIER_PORT=3200 AIMETIER_DATA_DIR=../data/pc \
  docker compose -f docker/docker-compose.quickstart.yml up --build

Note: AIMETIER_DATA_DIR is resolved relative to the compose file (docker/), so ../data/pc maps to data/pc in the project root.

Manual Docker Build

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

Data Persistence

All data is persisted under the bind mount (./data/docker-aimetier):

• 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 aimetier \
  -p 3100:3100 \
  -e HOST=0.0.0.0 \
  -e AIMETIER_HOME=/aimetier \
  -e OPENAI_API_KEY=sk-... \
  -e ANTHROPIC_API_KEY=sk-... \
  -v "$(pwd)/data/docker-aimetier:/aimetier" \
  aimetier-local

Without API keys, the app runs normally — adapter environment checks will surface missing prerequisites.