Update Docker documentation with production setup and troubleshooting

docusaurus/docs/cms/faq.md

@@ -18,6 +18,7 @@ tags:
 - typescript
 - database
 - foreign keys
+- docker
 
 ---
 
@@ -140,6 +141,23 @@ By default, most package managers enable hoisting, however, if it's not function
 
 You can see the <ExternalLink to="https://feedback.strapi.io/" text="public roadmap"/> to see which feature requests are currently being worked on and which have not been started yet, and to add new feature requests.
 
+## Why doesn't Strapi provide official Docker images?
+
+Strapi is a framework used to build many different types of applications. A single Docker image cannot cover all use cases, so Strapi provides Dockerfile examples instead. See the [Docker installation guide](/cms/installation/docker) for details.
+
+## Why use different Dockerfiles for development and production with Docker?
+
+Strapi builds the admin panel with React and bundles it into the application during the build process. The Strapi backend serves the admin panel as a web server, and the following environment variables are statically compiled into the built admin panel:
+
+- `STRAPI_ADMIN_BACKEND_URL`
+- `ADMIN_PATH` (if using a custom admin path)
+
+Because these values are baked in at build time, you must either pass them as `ARG` in your Dockerfile or rebuild the image when they change. Without this, the admin panel may point to `localhost:1337` instead of your production URL.
+
+Additionally, development images are not optimized for performance and should not be exposed to the public internet. Building separate Docker images for each environment ensures correct configuration and better security.
+
+See the [Docker installation guide](/cms/installation/docker) for full Dockerfile examples.
+
 ## Is there an MCP server for Strapi?
 
 There’s currently no MCP (<ExternalLink to="https://www.anthropic.com/news/model-context-protocol" text="Model Context Protocol" />) server available, but it’s in the works!

docusaurus/docs/cms/installation.md

@@ -14,6 +14,6 @@ Strapi projects can be installed either locally on a computer or on a remote ser
 
 <CustomDocCard title="CLI" description="Create a project on your local machine using the CLI." link="/cms/installation/cli" />
 
-If you already have an existing Strapi project on your local machine, the following guide provides step-by-step instructions on creating a custom Docker image for your project:
+If you already have an existing Strapi project on your local machine, the following guide covers running it in Docker containers for development and production:
 
-<CustomDocCard title="Docker" description="Create a custom Docker container from a local project." link="/cms/installation/docker" />
+<CustomDocCard title="Docker" description="Build and run a Strapi project in Docker for development and production." link="/cms/installation/docker" />