Released Images for zot¶
This document describes the available zot images for the various supported hardware and software platforms, along with information about image variations, image locations, and image naming formats.
Supported platforms¶
zot is supported on Linux and Apple MacOS platforms with Intel or ARM processors.
Table: Supported platforms and architectures
OS | ARCH | Platform |
---|---|---|
linux | amd64 | Intel-based Linux servers |
linux | arm64 | ARM-based servers and Raspberry Pi4 |
darwin | amd64 | Intel-based MacOS |
darwin | arm64 | ARM-based MacOS (Apple M1) |
freebsd | amd64 | Intel-based FreeBSD* |
freebsd | arm64 | ARM-based FreeBSD* |
**NOTE:* While binary images are available for FreeBSD, building container images is not supported at this time.
Full and minimal binary images¶
In addition to variations for specific platforms and architectures, binary images are also available in full and minimal flavors:
-
A full zot binary image is compiled with all extensions. Extensions include functions such as metrics, registry synchronization, search, and scrub.
-
A minimal distribution-spec conformant zot binary image is compiled with only a minimal set of code and libraries, reducing the attack surface. This option might be optimal for a registry embedded in a shipping product.
Binary image file naming¶
An executable binary image for zot is named using the target platform and architecture from the Supported platforms and architectures table. The general format of a binary image file name is one of these two:
zot-<os>-<architecture>
- A full zot binary image with all extensions has a filename of the form
zot-<os>-<architecture>.
For example, the full binary image for an Intel-based linux server iszot-linux-amd64
.
zot-<os>-<architecture>-minimal
- A minimal distribution-spec conformant zot binary image has a filename of the form
zot-<os>-<architecture>-minimal
. For example, the minimal binary image for an Intel-based linux server iszot-linux-amd64-minimal
.
For convenience, you can rename the binary image file to simply
zot
after downloading.
Where to get zot¶
You can download native executable binary images or container (Docker) images.
Getting binary images¶
The zot project is hosted on GitHub at project-zot.
To download a binary image, go to the zot releases and select a release. Go to the Assets section of the release page and download the binary for your platform and architecture.
You may need to use the
chmod
command to make the image executable.When downloading a binary image for MacOS, download the darwin image.
Getting container images¶
You can download a container image from ghcr.io
by forming a URL with the desired image name, such as:
https://ghcr.io/project-zot/zot-<os>-<architecture>[-<build>]
If <build>
is not specified, the default is full
. For example, to download the minimal binary image for an Intel-based linux server. The URL is:
https://ghcr.io/project-zot/zot-linux-amd64-minimal
When downloading a container image for MacOS, download the linux image, not the darwin image.
Licensing¶
zot is released under the Apache License 2.0.