NATS v2.15.2 build recipe

The recipe ReadyStack built readystack/nats:v2.15.2-CE-ubuntu24.04-r2 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 28 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 28 recipe files; the build kit itself keeps its own terms.

Upstream source

Public

github.com/nats-io/nats-server (v2.15.2) at 5a815f11a911efa2c88fd1dbfb18ed89a449bfc1

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_EPOCH1793028235 (2026-10-26T15:23:55Z)
  • Target digest (linux/amd64)sha256:ed77bffbe5e2c9ab2740c0a09f618e1f6b62371a91523126bd975fa118dfbf02
  • Target config digestsha256:21ad6a6e0cef48a353861486c53975e42908a5e74d633da1c8bdc77e9ba3de44
  • Checksummed kit files2,009 (CHECKSUMS.sha256)

Dockerfile Dockerfile.offline.pinned

56 lines · 4.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_nats-server
WORKDIR /src
COPY vendored/nats-src/ .
ENV CGO_ENABLED=0 GOTOOLCHAIN=local GOWORK=off GOFLAGS="-mod=vendor -buildvcs=false" GOPROXY=off SOURCE_DATE_EPOCH=1793028235
RUN go build -trimpath -ldflags='-w -X github.com/nats-io/nats-server/v2/server.gitCommit=5a815f1 -X github.com/nats-io/nats-server/v2/server.serverVersion=v2.15.2' -o /nats-server . && /nats-server --version > /tmp/nats-server.version 2>&1; cat /tmp/nats-server.version; grep -qF 'nats-server: v2.15.2' /tmp/nats-server.version || { echo 'nats-server --version does not report nats-server: v2.15.2'; exit 1; } && \
    { readelf -lW /nats-server | sed -n 's/.*Requesting program interpreter: \(.*\)]$/\1/p'; readelf -dW /nats-server | sed -n 's/.*Shared library: \[\(.*\)\]$/\1/p'; } > /nats-server.needs
# rs-probe: the HEALTHCHECK helper (standard library only, from the kit's rs-probe.go)
FROM golang:1.27.3-bookworm@sha256:972b4110ba0f47539a975c31e52c64765e1ff19f2d74469ae4a595c6676e80a5 AS build_rs_probe
WORKDIR /probe
COPY rs-probe.go main.go
COPY rs-probe.mod go.mod
ENV CGO_ENABLED=0 GOTOOLCHAIN=local GOFLAGS="-buildvcs=false" GOPROXY=off SOURCE_DATE_EPOCH=1793028235
RUN go build -trimpath -ldflags='-s -w' -o /rs-probe .
# the chiselled rootfs (vendored/chisel, cut by Dockerfile.vendor), the service user, the binaries
FROM ubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c AS rootfs
ARG SOURCE_DATE_EPOCH=1793028235
ADD vendored/chisel/rootfs.tar /rootfs/
RUN printf 'nats:x:999:999::/var/lib/nats:/bin/sh\n' >> /rootfs/etc/passwd && printf 'nats:x:999:\n' >> /rootfs/etc/group && \
    mkdir -p /rootfs/var/lib/nats /rootfs/data && chown -R 999:999 /rootfs/var/lib/nats /rootfs/data
COPY --from=build_nats-server /nats-server /rootfs/usr/bin/nats-server
COPY --from=build_nats-server /nats-server.needs /tmp/needs/nats-server
COPY --from=build_rs_probe /rs-probe /rootfs/usr/local/bin/rs-probe

Continues: 32 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

28 files · SHA-256 of each as published here
FileSizeSHA-256Access
BASES.tsv262 B203db39d3116…Public · View
BUILD_OFFLINE.sh6.6 KB83299978ccd0…Opening lines public
CHECKSUMS.sha256253 KB975ddbf21342…Free account
DOCKERFILE_NAME.txt26 B9aadd1ede68e…Public · View
Dockerfile4.6 KB97df5bcf81c3…Free account
Dockerfile.offline4.6 KB97df5bcf81c3…Free account
Dockerfile.offline.pinned4.6 KB97df5bcf81c3…Opening lines public
Dockerfile.vendor4.1 KBde52486bab50…Free account
MANIFEST.txt120 KBaddcf71d914b…Free account
SOURCE_DATE_EPOCH.txt11 B0f39174a54ff…Public · View
TARGET_DIGEST.txt308 B5b957206cf5c…Public · View
VERIFY_OFFLINE.sh7.2 KB8b036b1f9a7f…Free account
docs/PROVENANCE.md1.7 KB131ce4855633…Free account
docs/REBUILD.md5.0 KBb76f168aceac…Free account
docs/VERIFY.md1.9 KBab5cdd209b64…Free account
docs/provenance/BASE_IMAGE_DIGESTS.lock69 B273f709fa19f…Public · View
docs/provenance/BUILD_RECIPE.json2.8 KB646f6c7ebe1c…Free account
docs/provenance/CUSTODY_INPUTS.json649 Be118e6bbef69…Free account
docs/provenance/SOURCE_FILE_MANIFEST.json24 KB864b3398b61c…Free account
docs/provenance/SOURCE_TREE_HASH.json306 B29581605ab79…Public · View
docs/provenance/SYSTEM_PINNING.lock28 Bfa091140511e…Free account
docs/provenance/TOOLCHAIN.lock2.0 KBe7f088d59250…Free account
nats-server.conf857 Bfb002d937e31…Free account
readystack-entrypoint.sh1.7 KB58468a1384ce…Free account
rebuild.json1.4 KBee4c0793dd1e…Free account
rs-probe.go3.1 KBa8bdee17a358…Free account
rs-probe.mod40 Ba480b79acf98…Free account
toolchain/BUILDKIT_TAG.txt22 Bfcd530eeb02b…Public · View

Made from ReadyStack-nats-v2.15.2-CE-ubuntu24.04-r2.tar.gz (SHA-256 afe21ed2b0b60861468c67eb0a007fb4284ce2f86bd277a9f1a25a06c4163a59), 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,312 files, 49 MB
  • Handbooks, SBOM, security report and records654 files, 15 MB