Container Images
Some environments require container images to be approved and mirrored into a local registry before they can be used. This page lists the images an Anvil cluster uses with its default configuration, and the configuration fields that control each one.
<versionTag> refers to the cluster’s versionTag config value, and <operatorVersion> to the version of the Anvil Operator.
Image prefixes
Anvil’s own images are pulled using one of two prefixes:
imagePrefixPublic(defaultanvil.works/public/)imagePrefixPrivate(defaultanvil.works/on-site/)
If you mirror Anvil’s images into your own registry, set imagePrefix to override both.
Third-party images (such as busybox:latest) are not affected by these prefixes, and must be overridden individually.
Core images
These images are used by every cluster.
| Image | Configured by |
|---|---|
anvil.works/on-site/anvil-operator:<operatorVersion> |
image and version Helm chart values |
anvil.works/on-site/anvil-platform-server:<versionTag> |
platformServers.image |
anvil.works/public/anvil-postgres-auto-upgrade:10 |
postgresDbVersionplatformDbImageOverride |
anvil.works/public/anvil-timescale-auto-upgrade:14 |
timescaleDbVersion |
busybox:latest |
busyboxImage |
haproxy:3.2 |
haproxyImageloadBalancer.imagedeploymentPools.<key>.loadBalancer.image |
linuxserver/openssh-server:latest |
sshServerImage |
The operator image is also used for database migrations and cluster monitoring.
If allowDbUpgrade is set to false:
anvil-postgresis used instead ofanvil-postgres-auto-upgradeanvil-timescaleis used instead ofanvil-timescale-auto-upgrade
PDF renderer
Used when pdfRenderer.enabled is true (default true).
| Image | Configured by |
|---|---|
anvil.works/public/anvil-pdf-renderer:<versionTag> |
pdfRenderer.image |
Server environments
Dynamic server environments
Used when downlinks.mode is "podman" (default "podman").
| Image | Configured by |
|---|---|
anvil.works/public/anvil-downlink-dynamic:<versionTag> |
|
anvil.works/public/downlink-registry:<versionTag> |
|
anvil.works/public/anvil-downlink-base-python310-minimal:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python310-standard:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python310-datascience:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python310-machine-learning:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python312:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python313:latest |
downlinks.baseImages[].repo |
anvil.works/public/anvil-downlink-base-python314:latest |
downlinks.baseImages[].repo |
Legacy “Full Python 3” server environment
Used when legacyDownlinks.count is greater than zero (default 1).
| Image | Configured by |
|---|---|
anvil.works/public/anvil-downlink-python3-minimal:latest |
legacyDownlinks.image |
AI agents
Used when agents.enabled is true (default false).
| Image | Configured by |
|---|---|
anvil.works/public/anvil-agent-host:<versionTag> |
agents.agentHostImageagents.agentHostImageTag |
anvil.works/public/anvil-downlink-dynamic:<versionTag> |
Metrics
Used when metrics.enabled is true (default false).
| Image | Configured by |
|---|---|
grafana/grafana:12.3.1 |
metrics.grafana.image |
grafana/alloy:v1.12.2 |
metrics.alloy.image |
grafana/loki:3.6.3 |
metrics.loki.image |
prom/prometheus:v3.9.1 |
metrics.prometheus.image |
adonato/query-exporter:4.0.1 |
metrics.queryExporter.image |
quay.io/prometheus/node-exporter:v1.8.2 |
metrics.nodeExporter.image |
Tracing
Used when tempo.enabled is true (default true).
| Image | Configured by |
|---|---|
grafana/tempo:2.9.1 |
tempo.image |
Backups
Used when restoring from a backup.
| Image | Configured by |
|---|---|
anvil.works/public/anvil-postgres:10 |
|
anvil.works/public/anvil-timescale:14 |
|
anvil.works/on-site/anvil-platform-server:latest |
|
busybox:latest |
busyboxImage in the ClusterRestore spec |
linuxserver/openssh-server:latest |
sshServerImage in the ClusterRestore spec |
Do you still have questions?
Our Community Forum is full of helpful information and Anvil experts.