Distribution Registry v3.1.2 build recipe

The recipe ReadyStack built readystack/registry:v3.1.2-CE-ubuntu24.04-r5 from: the upstream source it starts from, every pinned input, and the files that run the build with the network off. Public here: the source and commit, the pinned inputs, all 25 recipe files with their sizes and SHA-256, 9 of them public in full or in part, and the opening lines of the Dockerfile and build script.

The whole recipe

Free account

An account is an email address, a username and a password: no card, no donation. It opens all 25 recipe files; the build kit itself keeps its own terms.

Upstream source

Public

github.com/distribution/distribution (v3.1.2) at 3220848f15d9279c66a41aa0a257469e6aede1e9

Fetched once, with the network on, by the vendor step (Dockerfile.vendor) when the kit was made; the offline build uses the kit's vendored copies:

Pinned inputs

As JSON
  • Base imagegolang:1.26.10-bookworm@sha256:632dff7351799a5a9954a48dc06670ade72ee44e8c351cdc0e5a57af2fea21af
  • Base imageubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c
  • BuildKitmoby/buildkit:v0.31.2
    sha256:e0e67ea9c4bb07bdef683e29f70f3b623d1eb9c82274a9ec04e6bb0511449fb0
  • Build methodsource-rebuild-go
  • SOURCE_DATE_EPOCH1790250209 (2026-09-24T11:43:29Z)
  • Target digest (linux/amd64)sha256:9b7a9955779cf093257a24546a860c35f627315956b12a93b9a03f013dffc449
  • Target config digestsha256:cc63397e914d53ba944c4458c8e20a20111385b496f9eea724a8b388d85a3746
  • Checksummed kit files9,311 (CHECKSUMS.sha256)

Dockerfile Dockerfile.offline.pinned

38 lines · 3.5 KB
# GENERATED L-009 hermetic build (--network=none, SBOM+SLSA-attestation-producing).
# Pinned bases from BASE_IMAGE_DIGESTS.lock; vendored Go tree + debs from Dockerfile.vendor.
FROM golang:1.26.10-bookworm@sha256:632dff7351799a5a9954a48dc06670ade72ee44e8c351cdc0e5a57af2fea21af AS build_registry
WORKDIR /src
COPY vendored/registry-src/ .
ENV CGO_ENABLED=0 GOTOOLCHAIN=local GOWORK=off GOFLAGS="-mod=vendor -buildvcs=false" GOPROXY=off SOURCE_DATE_EPOCH=1790250209
RUN go build -trimpath -ldflags='-s -w -X github.com/distribution/distribution/v3/version.version=3.1.2 -X github.com/distribution/distribution/v3/version.revision=3220848f15d9279c66a41aa0a257469e6aede1e9 -X github.com/distribution/distribution/v3/version.mainpkg=github.com/distribution/distribution/v3' -o /registry ./cmd/registry && /registry --version > /tmp/registry.version 2>&1; cat /tmp/registry.version; grep -qF 'v3 3.1.2' /tmp/registry.version || { echo 'registry --version does not report v3 3.1.2'; exit 1; }
FROM ubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c
ENV DEBIAN_FRONTEND=noninteractive OTEL_TRACES_EXPORTER=none
RUN --mount=type=bind,source=vendored/debs,target=/tmp/debs \
    set --; for f in /tmp/debs/*.deb; do [ -e "$f" ] && set -- "$@" "$f"; done; \
    for pass in 1 2 3 4 5; do [ $# -eq 0 ] || dpkg -i --skip-same-version "$@" >/dev/null 2>&1 && break; done; \
    dpkg --configure -a && bad= && for d in "$@"; do p=$(dpkg-deb -f "$d" Package) v=$(dpkg-deb -f "$d" Version); \
      case "$(dpkg-query -W -f='${Version} ${db:Status-Abbrev}' "$p" 2>/dev/null)" in "$v ii"*) ;; *) bad="$bad $p=$v" ;; esac; done && \
    { [ -z "$bad" ] || { echo "vendored debs not installed at their vendored version:$bad" >&2; false; }; } && \
    rm -rf /var/lib/apt/lists/* \
           /var/log/dpkg.log /var/log/alternatives.log /var/log/apt /var/cache/ldconfig/aux-cache /var/cache/fontconfig
ARG SOURCE_DATE_EPOCH=1790250209
RUN groupadd -r registry && useradd -r -g registry -d /var/lib/registry -m registry && \
    mkdir -p /etc/distribution /var/lib/registry && chown -R registry:registry /etc/distribution /var/lib/registry && \
    : "${SOURCE_DATE_EPOCH:?SOURCE_DATE_EPOCH must be set for a reproducible build}" && \
    sed -ri "s/^([^:]*:[^:]*):[0-9]*:/\1:$((SOURCE_DATE_EPOCH/86400)):/" /etc/shadow && \
    rm -f /etc/passwd- /etc/shadow- /etc/group- /etc/gshadow-
COPY --from=build_registry /registry /usr/bin/registry

Continues: 14 more lines. Create a free account to read the rest, or sign in.

Build script BUILD_OFFLINE.sh

125 lines · 6.6 KB
#!/usr/bin/env bash
# =============================================================================
# ReadyStack — offline reproducible rebuild.
#
# Rebuilds this product's image from THIS ARCHIVE ALONE, with no network access
# of any kind, and prints the resulting linux/amd64 image-manifest digest.
# Run ./VERIFY_OFFLINE.sh afterwards to assert it equals the published digest.
#
# Requirements: linux/amd64 Docker host, docker buildx >= 0.30, jq, tar.
# No git, no registry access, no additional tooling.
#
#   ./BUILD_OFFLINE.sh                the rebuild (OCI image + a docker-loadable copy)
#   ./BUILD_OFFLINE.sh --provenance   the same rebuild with SLSA v1 build provenance (mode=max) attached to the OCI
#                                     image, generated by BuildKit, not by any build step. Run on your own hardened,
#                                     isolated build platform and sign that provenance with a key the build cannot
#                                     reach, and the result meets SLSA Build Level 3 (see REBUILD.md). The image
#                                     digest is the same either way.
# =============================================================================
set -euo pipefail
PROVENANCE=0
for arg in "$@"; do
  case "$arg" in
    --provenance) PROVENANCE=1 ;;
    -h|--help) sed -n '2,20p' "$0"; exit 0 ;;

Continues: 101 more lines. Create a free account to read the rest, or sign in.

Recipe files

25 files · SHA-256 of each as published here
FileSizeSHA-256Access
BASES.tsv264 B8d72027e2bc4…Public · View
BUILD_OFFLINE.sh6.6 KB83299978ccd0…Opening lines public
CHECKSUMS.sha2561.4 MB2d2a6e6ae099…Free account
DOCKERFILE_NAME.txt26 B9aadd1ede68e…Public · View
Dockerfile3.5 KB26593ac93e8b…Free account
Dockerfile.offline3.5 KB26593ac93e8b…Free account
Dockerfile.offline.pinned3.5 KB26593ac93e8b…Opening lines public
Dockerfile.vendor1.6 KB03a066e5e05a…Free account
MANIFEST.txt790 KB6200b4e80eb1…Free account
SOURCE_DATE_EPOCH.txt11 Ba4b835b5cc32…Public · View
TARGET_DIGEST.txt276 Ba86ad53addd3…Public · View
VERIFY_OFFLINE.sh7.9 KBdc0b5cd5c104…Free account
config.yml1.6 KB49cca9f831fc…Free account
docs/PROVENANCE.md1.7 KBb48879396ba9…Free account
docs/REBUILD.md5.0 KB8940ea503577…Free account
docs/VERIFY.md1.9 KB11ecbf62f250…Free account
docs/provenance/BASE_IMAGE_DIGESTS.lock74 Baf50099de4bd…Public · View
docs/provenance/BUILD_RECIPE.json4.2 KBc9737c54d4ba…Free account
docs/provenance/CUSTODY_INPUTS.json658 Bc9d7ca2536f7…Free account
docs/provenance/SOURCE_FILE_MANIFEST.json305 KBc29b0fe5b8c2…Free account
docs/provenance/SOURCE_TREE_HASH.json316 Bba888dab5412…Public · View
docs/provenance/SYSTEM_PINNING.lock28 Bfa091140511e…Free account
docs/provenance/TOOLCHAIN.lock3.5 KB7df1c16a66d4…Free account
rebuild.json1.4 KB6d94dc59a6ac…Free account
toolchain/BUILDKIT_TAG.txt22 Bfcd530eeb02b…Public · View

Made from ReadyStack-registry-v3.1.2-CE-ubuntu24.04-r5.tar.gz (SHA-256 faa57554ab3a612ca444deab313620fb41c304a00dd3b5a1f724010c572c87ee), the build kit on sale for this release, on 2026-10-29.

What the Hermetic Build Kit adds

Free with a verified email

The recipe pins every input; the kit carries them, so the build runs with the network off:

  • Base images (OCI layouts)16 files, 311 MB
  • Pinned BuildKit toolchain1 files, 106 MB
  • Vendored sources and packages4,620 files, 64 MB
  • Handbooks, SBOM, security report and records4,651 files, 63 MB