Document the 'repro' tag in README

Antiz96 · Antiz96 · commit ec82ba398eb6 · 2026-03-23T13:20:20.000+01:00
diff --git a/README.md b/README.md
@@ -12,11 +12,16 @@ Arch Linux provides OCI-Compliant container images in multiple repositories:
 * [Daily in our ghcr.io repository][ghcr-containers]:
 `podman pull ghcr.io/archlinux/archlinux:latest` or `docker pull ghcr.io/archlinux/archlinux:latest`
 
-Three versions of the image are provided: `base` (approx. 150 MiB), `base-devel`
+Four versions of the image are provided: `base` (approx. 150 MiB), `base-devel`
 (approx. 260 MiB) and `multilib-devel` (approx. 300MiB) containing the
-respective meta package. All of them are available as
-tags with `latest` pointing to `base`. Additionally, images are tagged with their
-date and build job number, f.e. `base-devel-20201118.0.9436`.
+respective meta package; and `repro` which is a bit for bit reproducible image
+based on the `base` version (note that, to ensure reproducibility, the pacman keys 
+are stripped from this image so you're expected to run 
+`pacman-key --init && pacman-key --populate archlinux` before being able to update 
+the system and install packages via `pacman`).  
+All of them are available as tags with `latest` pointing to `base`.
+Additionally, images are tagged with their date and build job number, 
+f.e. `base-devel-20201118.0.9436`.
 
 While the images are regularly kept up to date it is strongly recommended
 running `pacman -Syu` right after starting a container due to the rolling
@@ -35,7 +40,7 @@ $ cosign verify ghcr.io/archlinux/archlinux:latest --certificate-identity-regexp
 * Provide the Arch experience in a Docker image
 * Provide the simplest but complete image to `base`, `base-devel` and
 `multilib-devel` on a regular basis
-* `pacman` needs to work out of the box
+* `pacman` needs to work out of the box (with the expection of the `repro` image for now, due to technical constraints)
 * All installed packages have to be kept unmodified
 
 >>>
@@ -67,7 +72,7 @@ Make sure your user can directly interact with Podman (i.e. `podman info` works)
 ### Usage
 There are multiple `make image-XXX` targets, where each creates the
 respective `archlinux:XXX` image based on the corresponding meta package.
-Currently those include `base`, `base-devel` and `multilib-devel`.
+Currently those include `base`, `base-devel`, `multilib-devel` and `repro`.
 
 ## Pipeline
 
@@ -118,4 +123,4 @@ Every year in June the content of the protected `GITLAB_PROJECT_TOKEN` variable
 
 [self-container-registry]: https://gitlab.archlinux.org/archlinux/archlinux-docker/container_registry
 
-[access-tokens]: https://gitlab.archlinux.org/archlinux/archlinux-docker/-/settings/access_tokens
+[access-tokens]: https://gitlab.archlinux.org/archlinux/archlinux-docker/-/settings/access_tokens
