Skip to content

Update Docker documentation with production setup and troubleshooting#3109

Draft
pwizla wants to merge 1 commit intomainfrom
cms/update-docker-documentation
Draft

Update Docker documentation with production setup and troubleshooting#3109
pwizla wants to merge 1 commit intomainfrom
cms/update-docker-documentation

Conversation

@pwizla
Copy link
Copy Markdown
Collaborator

@pwizla pwizla commented Apr 29, 2026

This PR rewrites the Docker documentation page to address user feedback about outdated content.

  • Restructure page into clear sections: development, production, troubleshooting, community tools
  • Add .dockerignore file guidance (prevents architecture mismatches and bloated images)
  • Add .env.example with concrete placeholder values
  • Fix production Dockerfile bug (devDependencies now installed in build stage)
  • Add production docker-compose.prod.yml with PostgreSQL and healthchecks
  • Add HEALTHCHECK directive using Strapi's /_health endpoint
  • Add healthchecks on all database services in docker-compose examples
  • Fix docker-compose: remove deprecated version key, pin mariadb:11.4, use mysql:8.4
  • Add troubleshooting section: Sharp/libvips, Apple Silicon/ARM, database connections
  • Update community tools: add Strapi 5 caution on dockerize, remove abandoned deployify, add naskio/strapi and vshadbolt/strapi community images
  • Add Next steps section
  • Rewrite FAQ in active voice
  • Update Docker card description on installation index page

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2026

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

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Apr 29, 2026 3:31pm

Request Review

@github-actions github-actions Bot added internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: CMS labels Apr 29, 2026
@pwizla pwizla self-assigned this Apr 29, 2026
@pwizla pwizla marked this pull request as draft April 29, 2026 16:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant