gomods/athens repository overview

⁠Welcome, Athenian!

This repository is where you'll find Docker images of Athens⁠ for you to use. There are three types of tags in here:

⁠Semantic versioned tags

For example, v0.7.0.

These are official releases of Athens⁠. They correspond to the GitHub tags⁠ that we make, and you can see the release notes for them here: https://github.com/gomods/athens/releases⁠.

Once these tags show up in this repository, they will never change.

For production deployments of Athens, we strongly recommend using one of these tags, e.g. gomods/athens:v0.2.0, instead of the latest or canary tags.

⁠latest

This image is the most recent stable release. For example, if the latest tagged image (see below) is v0.1.2, then the latest tagged image will be exactly the same binary as that one.

These images will change after every new Athens release. Although they are official releases of Athens, be aware that if you use this tag in production, it will change as we do releases.

⁠canary

This is the most recent build to master! It changes a lot and is very unstable.

We recommend that you don't use it except for development purposes.

⁠Want canary without the volatility?

If you're interested in getting access to unreleased functionality, but you don't want to use the canary tag, we provide images in gomods/athens-dev⁠ that are tagged with every commit made to the master branch⁠ of Athens.

Each tag is published once and the images never change. If you need functionality that is unreleased, we recommend using these images, but note that these builds still may be unstable.