Agentex local dev uses public Docker Hub base images by default. The agentex/Dockerfile
accepts an optional DOCKER_REGISTRY build arg — leave it unset for open-source onboarding.
Before ./dev.sh or make dev:
python scripts/agentex_dev_doctor.pyChecks: docker, uv, daemon reachable, agentex/docker-compose.yml present, critical ports
free, and DOCKER_REGISTRY not pointing at private ECR (#163).
| Symptom | Fix |
|---|---|
401 Unauthorized pulling *.amazonaws.com base image |
unset DOCKER_REGISTRY and rebuild |
Redis port conflict on 6379 |
brew services stop redis (macOS) |
Postgres port conflict on 5432 |
Stop local Postgres or change host mapping |
| Docker not running | Start Docker Desktop |
./dev.sh # macOS/Linux orchestration
# or
cd agentex && make devThe compose file builds agentex/Dockerfile target dev without a private registry prefix.