Skip to content

Use lockfile-based installs and document alternative base image for Docker#3046

Merged
pwizla merged 1 commit intostrapi:mainfrom
singhvishalkr:docs/2577-improve-dockerfile-examples
Apr 13, 2026
Merged

Use lockfile-based installs and document alternative base image for Docker#3046
pwizla merged 1 commit intostrapi:mainfrom
singhvishalkr:docs/2577-improve-dockerfile-examples

Conversation

@singhvishalkr
Copy link
Copy Markdown
Contributor

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

@pwizla pwizla changed the title docs(docker): use lockfile-based installs and document alternative base image Use lockfile-based installs and document alternative base image for Docker Apr 13, 2026
@pwizla pwizla self-assigned this Apr 13, 2026
@pwizla pwizla added this to the 6.21.0 milestone Apr 13, 2026
@pwizla
Copy link
Copy Markdown
Collaborator

pwizla commented Apr 13, 2026

Thank you for your initiative again, and thank you for your attention to details, @singhvishalkr

I also fixed the PR title for you on this one.

The PR is now approved, merged, should be live on docs.strapi.io in a few minutes, and will be mentioned in the next weekly snapshot release.

@pwizla pwizla merged commit 08a69d6 into strapi:main Apr 13, 2026
8 of 10 checks passed
pwizla added a commit that referenced this pull request Apr 13, 2026
…se image (#3046) (#3049)

Co-authored-by: Vishal Kumar Singh <vishal.kr.singh2021@gmail.com>
@pwizla pwizla added the contribution PRs that are part of the Documentation Contribution Program label Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution PRs that are part of the Documentation Contribution Program pr: chore source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: General improvements to the example dockerfile

2 participants