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 (default anvil.works/public/)
  • imagePrefixPrivate (default anvil.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 postgresDbVersion
platformDbImageOverride
anvil.works/public/anvil-timescale-auto-upgrade:14 timescaleDbVersion
busybox:latest busyboxImage
haproxy:3.2 haproxyImage
loadBalancer.image
deploymentPools.<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-postgres is used instead of anvil-postgres-auto-upgrade
  • anvil-timescale is used instead of anvil-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.agentHostImage
agents.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.