Paperless-ngx v3.3.4 build recipe

The recipe ReadyStack built readystack/paperlessngx:v3.3.4-CE-ubuntu24.04-r4 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 27 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 27 recipe files; the build kit itself keeps its own terms.

Upstream source

Public

github.com/paperless-ngx/paperless-ngx (v3.3.4) at 558cb01a1ddc85b3753d8fcaf5f024e7456a5c82

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 imageubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c
  • BuildKitmoby/buildkit:v0.31.2
    sha256:e0e67ea9c4bb07bdef683e29f70f3b623d1eb9c82274a9ec04e6bb0511449fb0
  • Build methodsource-rebuild-python
  • SOURCE_DATE_EPOCH1792706327 (2026-10-22T21:58:47Z)
  • Target digest (linux/amd64)sha256:3592e6f6da0d61d05c7030522e63614dc9390867c5d439455fce62edc9d01510
  • Target config digestsha256:648fb6ec219d355ce00c4d941c8655d55ca398c2cd4c2133419b6f2877d42845
  • Checksummed kit files1,731 (CHECKSUMS.sha256)

Dockerfile Dockerfile.offline.pinned

65 lines · 6.7 KB
# =====================================================================
# Paperless-ngx v3.3.4 (GPL-3.0) HERMETIC OFFLINE BUILD. --network=none.
# Reassembles the vendored built filesystem onto the PINNED public ubuntu:24.04 base.
# =====================================================================
# CPython 3.12.15 COMPILED HERE, offline (--network=none), from python.org's tarball (sha256 re-checked) and
# the vendored build debs, by the same command the vendor stage ran; linked against Ubuntu's libraries.
FROM ubuntu:24.04@sha256:24737cef17f4e22b1977df7d9a05e77c4e28b7da5b8911f8d8ccda136bf3573c AS cpython
ARG SOURCE_DATE_EPOCH=1791257664
ENV SOURCE_DATE_EPOCH=${SOURCE_DATE_EPOCH}
COPY vendored/paperlessngx-src/python/debs/ /tmp/cpython-debs/
COPY vendored/paperlessngx-src/python/Python-3.12.15.tar.xz /tmp/Python-3.12.15.tar.xz
RUN set --; for f in /tmp/cpython-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; }; } && \
    : "${SOURCE_DATE_EPOCH:?the CPython build needs SOURCE_DATE_EPOCH}" && \
    echo "c2c4321961fab0fb999d66e0cecf521c2ab3994c7992873ea99e306c1094fd5a  /tmp/Python-3.12.15.tar.xz" | sha256sum -c - && \
    mkdir -p /usr/src/python && tar -xJf /tmp/Python-3.12.15.tar.xz -C /usr/src/python --strip-components=1 --no-same-owner && \
    rm -rf /tmp/cpython-debs /tmp/Python-3.12.15.tar.xz && cd /usr/src/python && \
    export DEB_BUILD_MAINT_OPTIONS=optimize=-lto && \
    PYCF="$(dpkg-buildflags --get CFLAGS) $(dpkg-buildflags --get CPPFLAGS)" && PYLD="$(dpkg-buildflags --get LDFLAGS)" && \
    ./configure --build=x86_64-linux-gnu --prefix=/usr/local --enable-shared --enable-loadable-sqlite-extensions --enable-option-checking=fatal --disable-test-modules --without-static-libpython --with-ensurepip=install --with-system-expat --without-system-libmpdec --with-dbmliborder= py_cv_module__dbm=n/a py_cv_module__gdbm=n/a py_cv_module__tkinter=n/a && \
    make -j"$(nproc)" "EXTRA_CFLAGS=$PYCF" "LDFLAGS=$PYLD,--strip-all" && \

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

27 files · SHA-256 of each as published here
FileSizeSHA-256Access
BASES.tsv121 B0da49a3ea98f…Public · View
BUILD_OFFLINE.sh6.6 KB83299978ccd0…Opening lines public
CHECKSUMS.sha256257 KB4ab0f4f956e8…Free account
DOCKERFILE_NAME.txt26 B9aadd1ede68e…Public · View
Dockerfile6.7 KBd7b44e6741df…Free account
Dockerfile.offline6.7 KBd7b44e6741df…Free account
Dockerfile.offline.pinned6.7 KBd7b44e6741df…Opening lines public
Dockerfile.vendor14 KB52d374564610…Free account
MANIFEST.txt142 KBae05d4d23c81…Free account
SOURCE_DATE_EPOCH.txt11 B714c15c8d72b…Public · View
TARGET_DIGEST.txt449 Ba45c2010088c…Public · View
VERIFY_OFFLINE.sh7.2 KB8b036b1f9a7f…Free account
constraints.txt5.9 KB9545a58a9cc9…Free account
docs/PROVENANCE.md1.7 KB7142b24d1789…Free account
docs/REBUILD.md5.0 KB56474c79f7fa…Free account
docs/VERIFY.md1.9 KB42066040a0a0…Free account
docs/provenance/BASE_IMAGE_DIGESTS.lock55 Bd119481183e4…Public · View
docs/provenance/BUILD_RECIPE.json2.6 KBe34c559bd349…Free account
docs/provenance/CUSTODY_INPUTS.json664 Bd757bf9670d0…Free account
docs/provenance/SOURCE_FILE_MANIFEST.json96 KB4a9ab537306a…Free account
docs/provenance/SOURCE_TREE_HASH.json322 B415b6f260a36…Public · View
docs/provenance/SYSTEM_PINNING.lock1 B01ba4719c80b…Free account
docs/provenance/TOOLCHAIN.lock1.1 KBc8bd902c5ce1…Free account
entrypoint.sh1.2 KB7130bde93f13…Free account
rebuild.json1.2 KB449167864c58…Free account
supervisor-paperless.conf1.1 KBe6398b4529f3…Free account
toolchain/BUILDKIT_TAG.txt22 Bfcd530eeb02b…Public · View

Made from ReadyStack-paperlessngx-v3.3.4-CE-ubuntu24.04-r4.tar.gz (SHA-256 6b41925afd704e4c91c33cfe04c01f589fe4e34f565c37fd144213b369f5bedf), 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:

  • Vendored sources and packages80 files, 2.1 GB
  • Pinned BuildKit toolchain1 files, 106 MB
  • Handbooks, SBOM, security report and records1,620 files, 98 MB
  • Base images (OCI layouts)5 files, 28 MB