Docker image tags
Delegaris is published to Docker Hub as goodhallsolutions/delegaris. Each release is published under two tags.
| Tag | What it is | Use when |
|---|---|---|
:0.9.0 | One exact release. It stays on that version until you change the tag yourself. | Production. You decide when to move to the next version. |
:latest | The 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.
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