Skip to main content

Custom Agent Runner Images

The default runner image is:

ghcr.io/agenta-ai/agenta-agent-runner:latest

Build a custom image when you need extra system packages, custom certificates, or a pinned runner build.

Build​

From the repository root:

docker build \
  -f services/agent/docker/Dockerfile \
  -t ghcr.io/<org>/agenta-agent-runner:<tag> \
  services/agent

The published image does not bundle Claude Code. If a harness needs Claude Code, the runner installs it from Anthropic at runtime.

Configure Compose​

AGENTA_AGENT_RUNNER_IMAGE_NAME=<org>/agenta-agent-runner
AGENTA_AGENT_RUNNER_IMAGE_TAG=<tag>

Configure Helm​

agentRunner:
  image:
    repository: ghcr.io/<org>/agenta-agent-runner
    tag: <tag>

Configure Railway​

export AGENTA_AGENT_RUNNER_IMAGE="ghcr.io/<org>/agenta-agent-runner:<tag>"

Then run the normal Railway deploy flow.