Runtime images
The operator doesn't run your agents itself. It launches pods from a set of adaptivelive/* images. Common images and how to change them. Check your release inventory for the full set.
When the operator reconciles a CR it creates pods from published images. The manager image is one; the rest launch on demand from an Agent's runtime and its session recording. The matrix matters for capacity planning and for air-gapped mirroring.
Operator-launched infrastructure
| Component | Default image (under adaptivelive/) | Override env var |
|---|---|---|
| Manager | autonomic-manager | set at install (image.manager.tag / exo-install) |
| Agentlet (per run) | autonomic-agentlet | AUTONOMIC_IMAGE_AGENTLET |
| Session recorder | session-recorder | AUTONOMIC_IMAGE_SESSION_RECORDER |
The agentlet is the sidecar that runs inside an Agent and drives the runtime CLI. The session recorder captures the asciicast stream.
Agent runtimes
An Agent's spec.runtime picks which coding-agent image the pod runs. Each receives credentials from its configured provider or agentToken Secret.
| runtime | image (adaptivelive/) | token env | override |
|---|---|---|---|
ClaudeCode | claudecode | ANTHROPIC_API_KEY | AUTONOMIC_IMAGE_CLAUDECODE |
Codex | codex | CODEX_API_KEY | AUTONOMIC_IMAGE_CODEX |
| Gemini | gemini | GEMINI_API_KEY | AUTONOMIC_IMAGE_GEMINI |
| Pi | pi | PI_API_KEY | AUTONOMIC_IMAGE_PI |
| Hermes | hermes | HERMES_API_KEY | AUTONOMIC_IMAGE_HERMES |
| Hal | hal | HAL_API_KEY | AUTONOMIC_IMAGE_HAL |
OpenCode | opencode | OPENCODE_API_KEY | AUTONOMIC_IMAGE_OPENCODE |
Also include images for the tools, apps, browsers, gateways, and other features you use. The tables are not a complete offline mirror inventory.
Overriding images
In the 11 November 2026 build, deployment container image controls manage target versions and resource controls apply updates. Older releases may differ. For installation-level overrides:
- Per resource. An Agent's
spec.image(or a Tool's custom image) chooses a reference for that object. Configured image targets can still update its tag. - Per image, cluster-wide. The
AUTONOMIC_IMAGE_*env vars above (agentlet, session recorder, and the runtime/tool images), set on the manager Deployment, override one child image verbatim. The manager's own image is pinned at install time (image.manager.tag/exo-install), not through these vars. - Cluster image configuration. The
autonomic-imagesConfigMap supplies image references when no per-image environment override is set. - Registry prefix.
AUTONOMIC_IMAGE_REGISTRYrewrites every default ref onto your mirror.
Per-image environment settings take priority over the ConfigMap, then the registry prefix, then the built-in default. Saved image targets change the selected tag while preserving the registry and repository.