WireGuard 0.0.20250522 build recipe

The recipe ReadyStack built readystack/wireguard:0.0.20250522-CE-ubuntu24.04-r1 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 26 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 26 recipe files; the build kit itself keeps its own terms.

Upstream source

Public

git.zx2c4.com/wireguard-go (0.0.20250522) at f333402bd9cbe0f3eeb02507bd14e23d7d639280

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.27.3-bookworm@sha256:972b4110ba0f47539a975c31e52c64765e1ff19f2d74469ae4a595c6676e80a5
  • Base imageubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c
  • BuildKitmoby/buildkit:v0.31.2
    sha256:e0e67ea9c4bb07bdef683e29f70f3b623d1eb9c82274a9ec04e6bb0511449fb0
  • Build methodsource-rebuild-go
  • SOURCE_DATE_EPOCH1747871102 (2025-05-21T23:45:02Z)
  • Target digest (linux/amd64)sha256:9a7cde50fe6f16cea9aeff4714ccb5a115d3b12b37c8df39bd11035fd2afdda9
  • Target config digestsha256:bb21104411c1e0a49d8445a247eb800aa5688f09693b021a592f159b61a99191
  • Checksummed kit files1,368 (CHECKSUMS.sha256)

Dockerfile Dockerfile.offline.pinned

38 lines · 3.6 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.27.3-bookworm@sha256:972b4110ba0f47539a975c31e52c64765e1ff19f2d74469ae4a595c6676e80a5 AS build_wireguard-go
WORKDIR /src
COPY vendored/wireguard-src/ .
ENV CGO_ENABLED=0 GOTOOLCHAIN=local GOWORK=off GOFLAGS="-mod=vendor -buildvcs=false" GOPROXY=off SOURCE_DATE_EPOCH=1747871102
RUN go build -trimpath -ldflags='' -o /wireguard-go . && /wireguard-go --version > /tmp/wireguard-go.version 2>&1; cat /tmp/wireguard-go.version; grep -qF 'wireguard-go v0.0.20250522' /tmp/wireguard-go.version || { echo 'wireguard-go --version does not report wireguard-go v0.0.20250522'; exit 1; }
FROM ubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c
ENV DEBIAN_FRONTEND=noninteractive
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=1747871102
RUN groupadd -r wireguard && useradd -r -g wireguard -d /var/lib/wireguard -m wireguard && \
    mkdir -p /config /var/run/wireguard && chown -R wireguard:wireguard /config /var/run/wireguard && \
    : "${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_wireguard-go /wireguard-go /usr/local/bin/wireguard-go

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

26 files · SHA-256 of each as published here
FileSizeSHA-256Access
BASES.tsv262 B203db39d3116…Public · View
BUILD_OFFLINE.sh6.6 KB83299978ccd0…Opening lines public
CHECKSUMS.sha256183 KB6cf46d691182…Free account
DOCKERFILE_NAME.txt26 B9aadd1ede68e…Public · View
Dockerfile3.6 KB868fc005c436…Free account
Dockerfile.offline3.6 KB868fc005c436…Free account
Dockerfile.offline.pinned3.6 KB868fc005c436…Opening lines public
Dockerfile.vendor1.7 KB6e2964f05325…Free account
MANIFEST.txt92 KB7076729d8ef0…Free account
SOURCE_DATE_EPOCH.txt11 B2c02a29ebd33…Public · View
TARGET_DIGEST.txt378 B35abfef42c61…Public · View
VERIFY_OFFLINE.sh9.9 KB3e8184ea230c…Free account
docs/PROVENANCE.md1.7 KBa8edf1c47c52…Free account
docs/REBUILD.md5.0 KB76f62657ed71…Free account
docs/VERIFY.md2.0 KB7c98ff6da9f0…Free account
docs/provenance/BASE_IMAGE_DIGESTS.lock74 B2438669402e1…Public · View
docs/provenance/BUILD_RECIPE.json1.3 KB7c3b6009d7f5…Free account
docs/provenance/CUSTODY_INPUTS.json655 B52ad8f24cb03…Free account
docs/provenance/SOURCE_FILE_MANIFEST.json3.0 KBc4bbf20b868e…Free account
docs/provenance/SOURCE_TREE_HASH.json312 B24e629f34e56…Public · View
docs/provenance/SYSTEM_PINNING.lock73 B841a12bde79b…Free account
docs/provenance/TOOLCHAIN.lock2.2 KB40ca03401c2d…Free account
netadmin802 B9da086672eb7…Free account
rebuild.json1.4 KB32f9b74a02a1…Free account
toolchain/BUILDKIT_TAG.txt22 Bfcd530eeb02b…Public · View
wireguard-entrypoint.sh4.1 KBa13236169323…Free account

Made from ReadyStack-wireguard-0.0.20250522-CE-ubuntu24.04-r1.tar.gz (SHA-256 d5834b19c1c3598e5cb7175dde33b3a2db00e1de986be75cd749b79553140bfb), 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, 315 MB
  • Pinned BuildKit toolchain1 files, 106 MB
  • Vendored sources and packages1,166 files, 15 MB
  • Handbooks, SBOM, security report and records161 files, 3.2 MB