Agentic Ecosystem Docker

Agentic Ecosystem Docker

[Created by Codex: 019b78e6-c6cb-7f72-ab5a-c16c536b8e70]

Purpose

Provide a repeatable workflow and checklists for Dockerizing the agentic ecosystem so docker compose up --build runs the UI and AMS with working /api/agent-sdk/*, Live Logs (SSE), and agent start/stop.

When To Use

• Need to run Agent HQ (or similar Vite UI) + AMS together via Docker Compose
• Need localhost-only exposure (bind 127.0.0.1:PORT:PORT)
• Seeing 403 forbidden from /api/agent-sdk/* or SSE endpoints in Docker (loopback checks)
• Need to mount centralized logs and provider CLIs into containers

Non-Negotiable Contract

• Publish the UI port only on loopback (example: 127.0.0.1:8037:8037)
• Do not publish AMS port (use expose, not ports)
• Bind Vite to 0.0.0.0 inside container
• Use Docker hostname for AMS from the UI (http://ams:8041)
• Run smoke tests after each phase before continuing

Workflow

1. Load references/agentic_ecosystem_docker_playbook.md and follow phases in order.
2. If a Linux Codex binary is required inside a container, run scripts/build_codex_linux_binary.py and mount the result into AMS.
3. Validate with curl-based smoke tests (HTML, /api/agent-sdk/list, SSE endpoints, start/stop).

Bundled Resources

• Step-by-step playbook: references/agentic_ecosystem_docker_playbook.md
• Linux Codex builder helper: scripts/build_codex_linux_binary.py