Skip to content

docs(docker): use lockfile-based installs and document alternative base image#3046

Open
singhvishalkr wants to merge 1 commit intostrapi:mainfrom
singhvishalkr:docs/2577-improve-dockerfile-examples
Open

docs(docker): use lockfile-based installs and document alternative base image#3046
singhvishalkr wants to merge 1 commit intostrapi:mainfrom
singhvishalkr:docs/2577-improve-dockerfile-examples

Conversation

@singhvishalkr
Copy link
Copy Markdown

Improves the Docker installation documentation with two changes:

Reproducible installs:

  • Development Dockerfiles: yarn install --frozen-lockfile / npm ci instead of plain yarn install / npm install
  • Production Dockerfiles: same lockfile flags for consistency
  • Ensures container builds are deterministic and match the lockfile exactly

Alternative base image note:

  • Added a tip about using node:22-slim (Debian-based) instead of node:22-alpine for environments with restricted network access
  • Sharp's prebuilt binaries work out of the box on Debian, avoiding the need to compile libvips from source
  • Addresses the DNS/network issues reported in [Bug]: General improvements to the example dockerfile #2577

Closes #2577

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Apr 11, 2026 2:52pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: General improvements to the example dockerfile

1 participant