bun

Use it as a base image

Reference it in the FROM line of your Dockerfile. Nonroot, read-only root filesystem, built for amd64 and arm64.

FROM ghcr.io/quenchworks/images/bun:1

Or pull it directly

docker pull ghcr.io/quenchworks/images/bun:1

Version line

1

Latest line

1

Architectures

amd64, arm64

Runs as

nonroot (uid 1001)

Root filesystem

read-only

License

MIT

Verify the supply chain

This image is cosign-signed and carries an SPDX SBOM and a SLSA build-provenance attestation on the same digest. Check all three before you build on it:

# 1. signature — built and signed by QuenchWorks CI
cosign verify ghcr.io/quenchworks/images/bun:1 \
  --certificate-identity-regexp 'https://github.com/quenchworks/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# 2. SLSA build provenance — which workflow built it, from what
gh attestation verify oci://ghcr.io/quenchworks/images/bun:1 --owner quenchworks

# 3. SPDX SBOM — the package inventory
gh attestation verify oci://ghcr.io/quenchworks/images/bun:1 --owner quenchworks \
  --predicate-type https://spdx.dev/Document

See the SBOM & provenance guide for reading the SBOM and using these checks in CI.

Best-practice Dockerfile for 1

Install dependencies with Bun's frozen lockfile in the build stage, build there, then copy the prod node_modules and built output onto a clean bun base.

1
# Build stage: install all deps (frozen) and build with Bun.
2
FROM ghcr.io/quenchworks/images/bun:1 AS build
3
USER root
4
WORKDIR /app
5
ENV BUN_INSTALL_CACHE_DIR=/tmp/bun
6

7
COPY package.json bun.lock ./
8
RUN ["bun", "install", "--frozen-lockfile"]
9
COPY . .
10
RUN ["bun", "run", "build"]
11
# Prune to production dependencies for the runtime stage.
12
RUN ["bun", "install", "--frozen-lockfile", "--production"]
13

14
# Runtime stage: prod deps + built output on a clean bun base, nonroot.
15
FROM ghcr.io/quenchworks/images/bun:1 AS runtime
16
WORKDIR /app
17
ENV NODE_ENV=production
18
COPY --from=build /app/node_modules ./node_modules
19
COPY --from=build /app/dist ./dist
20
COPY --from=build /app/package.json ./package.json
21
USER 1001
22
EXPOSE 3000
23
CMD ["bun", "run", "dist/server.js"]

This Dockerfile is pinned to the 1 line. For the line-by-line walkthrough and ecosystem variants (npm/Yarn, pip/uv/Poetry, Maven/Gradle), see the Build a Node app guide.