yarn
Runtime · Build tool · standard · v1
Node base with Yarn preinstalled. Use it as the build stage for Yarn projects. Lines 1 (classic) and 4 (berry).
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/yarn:1 Or pull it directly
docker pull ghcr.io/quenchworks/images/yarn:1 - Version line
- 1
- Latest line
- 1
- Architectures
- amd64, arm64
- Runs as
- nonroot (uid 1001)
- Root filesystem
- read-only
- License
- BSD-2-Clause
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/yarn: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/yarn:1 --owner quenchworks
# 3. SPDX SBOM — the package inventory
gh attestation verify oci://ghcr.io/quenchworks/images/yarn: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
Yarn Classic leads: preinstalled on the yarn base, it installs the production-only dependency set and builds, then a clean node base receives only the prod node_modules and the built output.
# Build stage: Yarn (Classic) installs the full set and builds.FROM ghcr.io/quenchworks/images/yarn:1 AS buildUSER rootWORKDIR /appENV YARN_CACHE_FOLDER=/tmp/yarn
COPY package.json yarn.lock ./RUN ["yarn", "install", "--frozen-lockfile"]COPY . .RUN ["yarn", "build"]
# Prod-deps stage: a clean install of production dependencies only.FROM ghcr.io/quenchworks/images/yarn:1 AS prod-depsUSER rootWORKDIR /appENV YARN_CACHE_FOLDER=/tmp/yarnCOPY package.json yarn.lock ./RUN ["yarn", "install", "--frozen-lockfile", "--production"]
# Runtime stage: prod node_modules + built dist on a slim node base, nonroot.FROM ghcr.io/quenchworks/images/node:24 AS runtimeWORKDIR /appENV NODE_ENV=productionCOPY --from=prod-deps /app/node_modules ./node_modulesCOPY --from=build /app/dist ./distCOPY --from=build /app/package.json ./package.jsonUSER 1001EXPOSE 3000CMD ["node", "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.
Upstream project: https://yarnpkg.com