Skip to main content

Docker image tags

Delegaris is published to Docker Hub as goodhallsolutions/delegaris. Each release is published under two tags.

TagWhat it isUse when
:0.9.0One exact release. It stays on that version until you change the tag yourself.Production. You decide when to move to the next version.
:latestThe newest release. It moves every time a version is published.Trying Delegaris out, a demo, or a test copy you are happy to update without warning.

There is no tag that follows a major or minor line (such as :0 or :0.9).

Choosing the tag​

The standard docker-compose.yml takes the tag from DELEGARIS_TAG, and uses latest when it is not set:

image: goodhallsolutions/delegaris:${DELEGARIS_TAG:-latest}

To pin a version, add it to .env:

DELEGARIS_TAG=0.9.0

Then pull and restart:

docker compose pull
docker compose up -d

With the tag pinned, docker compose pull fetches nothing new until you change DELEGARIS_TAG. To upgrade, change it to the new version and run the same two commands. See Upgrading.

tip

Pin a version in production, and pin the same version on every copy when you run more than one. Copies sharing a database should all run the same release.

Checking which version is running​

/healthz reports the version of the copy that answers:

curl -s http://127.0.0.1:8080/healthz
{"status": "ok", "version": "0.9.0", "node": "3f2a1c9e0b7d", "role": "active"}

The first line of the container log says the same: Delegaris 0.9.0 starting as ….

Platforms​

The published image is built for linux/amd64. For an arm64 host, such as an AWS Graviton instance, use the Linux package, which comes for arm64 as well.

Pinning to a digest​

Under tight change control, you can pin the image by its content digest instead of a tag, for example goodhallsolutions/delegaris@sha256:…. The image then cannot change underneath you, but you have to update the digest by hand for every release. This shows the digest of the image you have pulled:

docker image inspect --format '{{index .RepoDigests 0}}' goodhallsolutions/delegaris:0.9.0