readystack/bookstack repository overview

⁠BookStack

readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3

A cosign-signed build of github.com/BookStackApp/BookStack v26.09.2 (MIT), built clean-room from official upstream source by ReadyStack⁠.

⁠What you get

Signature, user and attestations below were measured on the published digest sha256:457d22b211af84ab4711054b20e36bc258b9e023192abf91104997397cf263b2 on 2026-10-27.

• Scan scores — we scan every image we publish every day (an SBOM made with syft, vulnerabilities matched with grype, scored with ce.rodeo's published rubric) and record each scan with how its score was derived. This release's first and latest scan: https://readystack.dev/products.html#bookstack⁠
• ReadyStack release check — passed at release on 2026-10-27: no fixable critical or high vulnerability (Docker Scout and OSV), a non-root user, SBOM and provenance attached. This is ReadyStack's own test, not a Docker grade; vulnerabilities published since then are in today's result at https://readystack.dev/queue⁠.
• Signed — cosign signature by the ReadyStack release key (fingerprint 04daa92344a52dbc) on this release's index digest sha256:457d22b211af84ab4711054b20e36bc258b9e023192abf91104997397cf263b2; verify with cosign verify --key https://readystack.dev/keys/cosign.pub readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3.
• Attestations — An SPDX SBOM and SLSA v1 build provenance are attached to this digest.
• Runs as a non-root user (bookstack).
• Built from source by ReadyStack.

⁠Which tag should I pull?

This image follows the ReadyStack release-tag convention:

• The current release is v26.09.2-CE-ubuntu24.04-r3 — the release on sale at readystack.dev. Release tags use the pattern <upstream-version>-CE-<base-os>-r<N>; the current one is signed, attested (SBOM + provenance), and is provided under the ReadyStack Agreement⁠.

• Earlier release tags (an older version or revision in the same pattern) are superseded. They stay pullable so existing deployments can pin them, but they are no longer re-graded, and fixes appear only in newer releases: move to the current release. For a superseded release's build kit, ask support.

• Any tag beginning with internal- is an engineering-pipeline artifact published for build observability. It is unsupported, may change or disappear without notice, and must not be used in production.

# ✓ current release
docker pull readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3

# ✗ unsupported (do not pull)
docker pull readystack/bookstack:internal-...

This release is signed; verify it with cosign verify --key https://readystack.dev/keys/cosign.pub readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3 (the signature is recorded in the public Sigstore transparency log). Support: [email protected]⁠, as set out in the ReadyStack Agreement⁠.

⁠Deployment

Single container (Apache + mod_php, one foreground process) running the BookStack Laravel/PHP application. It REQUIRES an EXTERNAL MySQL 8.0+ / MariaDB 10.6+ database the operator provisions and points the container at via DB_HOST/DB_PORT/DB_DATABASE/DB_USERNAME/DB_PASSWORD env vars — there is NO embedded/SQLite database. BookStack creates and migrates its own schema (php artisan migrate) on first start. NOT a multi-service cluster and NOT docker-compose/Kubernetes-only, but it is NOT self-contained: a MySQL/MariaDB server is a hard external dependency.

Secrets go in an env file that only you can read, not on the command line, and passwords that only set up the first start come out of it after setup. Create bookstack.env with install -m 600 /dev/null bookstack.env, then write these lines into it with an editor, with your own values (a value typed into a shell stays in its history). Docker reads each line as written: no quotes around a value, no spaces around =.

# Needed at every start; keep it unchanged for the life of the installation.
APP_KEY=base64:YOUR_32_BYTE_KEY
# Your MySQL/MariaDB user's password; needed at every start.
DB_PASSWORD=YOUR_DB_PW

docker run -d --name bookstack -p 8080:8080 --env-file ./bookstack.env -e APP_URL=https://books.example.com -e DB_CONNECTION=mysql -e DB_HOST=YOUR_DB_HOST -e DB_PORT=3306 -e DB_DATABASE=bookstack -e DB_USERNAME=bookstack -v bookstack-storage:/app/storage -v bookstack-uploads:/app/public/uploads readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3

Generate APP_KEY once with: docker run --rm --entrypoint php readystack/bookstack:v26.09.2-CE-ubuntu24.04-r3 /app/artisan key:generate --show (a literal placeholder key makes every page answer 500). Put the key on the APP_KEY line of bookstack.env; both lines of the file are read at every start.

⁠The full ReadyStack Hermetic Build Kit

The complete --network=none build kit for this image — plus admin/DB/API handbooks, the build's validation records, and its build provenance records — is at readystack.dev/buy.html⁠. A clean-room rebuild from this release's archive on an egress-blocked host reproduced its linux/amd64 digest sha256:a649f1eb980bbf47ef8db89e20124a3f9a13a9834872256c4a81d54a50565b94 on 2026-10-27.

— ReadyStack · readystack.dev