Files
SuperCharged-Claude-Code-Up…/dexto/README.Docker.md
admin b52318eeae feat: Add intelligent auto-router and enhanced integrations
- Add intelligent-router.sh hook for automatic agent routing
- Add AUTO-TRIGGER-SUMMARY.md documentation
- Add FINAL-INTEGRATION-SUMMARY.md documentation
- Complete Prometheus integration (6 commands + 4 tools)
- Complete Dexto integration (12 commands + 5 tools)
- Enhanced Ralph with access to all agents
- Fix /clawd command (removed disable-model-invocation)
- Update hooks.json to v5 with intelligent routing
- 291 total skills now available
- All 21 commands with automatic routing

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-28 00:27:56 +04:00

2.3 KiB
Raw Permalink Blame History

Running Dexto with Docker

This image runs the Dexto CLI in server mode (API + SSE streaming). It uses pnpm workspaces and builds from the current repo (no published packages required).

Build the image

docker build -t dexto:local .

Provide configuration and API keys

Create a .env file with your keys (see README.md):

OPENAI_API_KEY=...
# add other provider keys as needed

The coding agent config is baked into the image at /app/agents/coding-agent/coding-agent.yml. You can mount your own agents folder if desired.

Run: API server only (default)

docker run --rm \
  --env-file .env \
  -e API_PORT=3001 \
  -p 3001:3001 \
  dexto:local

What it does:

  • Starts REST + SSE streaming server on API_PORT (default 3001)
  • Uses Chromium inside the image for Puppeteer tools
  • Stores runtime data under /app/.dexto (incontainer)

Endpoints:

  • API base: http://localhost:3001/api/
  • Health: http://localhost:3001/health
  • MCP servers: http://localhost:3001/api/mcp/servers

Persist data between runs (recommended):

docker run --rm \
  --env-file .env \
  -e API_PORT=3001 \
  -p 3001:3001 \
  -v dexto_data:/app/.dexto \
  dexto:local

Use a custom agent config:

docker run --rm \
  --env-file .env \
  -e API_PORT=3001 \
  -e CONFIG_FILE=/app/agents/my-agent.yml \
  -v $(pwd)/agents:/app/agents:ro \
  -p 3001:3001 \
  dexto:local

Run with WebUI (optional)

The image embeds the built WebUI. To run the WebUI alongside the API, start the CLI in web mode. This requires two ports (frontend and API):

docker run --rm \
  --env-file .env \
  -e FRONTEND_PORT=3000 \
  -e API_PORT=3001 \
  -p 3000:3000 -p 3001:3001 \
  dexto:local \
  sh -c "node packages/cli/dist/index.js --mode web --agent $CONFIG_FILE"

Open the WebUI: http://localhost:3000 (the UI calls the API on http://localhost:3001).

Docker Compose (example)

services:
  dexto:
    image: dexto:local
    build: .
    environment:
      API_PORT: 3001
    ports:
      - "3001:3001"
    volumes:
      - dexto_data:/app/.dexto
      - ./agents:/app/agents:ro
    env_file: .env

volumes:
  dexto_data: {}

Notes

  • Healthcheck uses API_PORT (falls back to PORT or 3001).
  • The container runs as a nonroot user (dexto).
  • The image builds from your repo code; no published @dexto/core is required.