From 17acb93ae2165eabc16d18c30df135f95d3b01d3 Mon Sep 17 00:00:00 2001 From: Mauricio Siu Date: Wed, 17 Dec 2025 23:27:43 -0600 Subject: [PATCH] docs: add guidance for using private registries with Docker Stack - Included a callout in the Docker Compose documentation to inform users about the necessity of the `--with-registry-auth` flag when deploying with Docker Stack and private registries. - Explained the implications of not using the flag, including potential authentication errors on worker nodes. Resolved https://github.com/Dokploy/dokploy/issues/3111 --- apps/docs/content/docs/core/docker-compose/index.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/apps/docs/content/docs/core/docker-compose/index.mdx b/apps/docs/content/docs/core/docker-compose/index.mdx index 1659354..34f3a34 100644 --- a/apps/docs/content/docs/core/docker-compose/index.mdx +++ b/apps/docs/content/docs/core/docker-compose/index.mdx @@ -43,6 +43,15 @@ We provide a webhook so that you can trigger your own deployments by pushing to This section provides advanced configuration options for experienced users. It includes tools for custom commands within the container and volumes. - **Command**: Dokploy has a defined command to run the Docker Compose file, ensuring complete control through the UI. However, you can append flags or options to the command. + + + If you're deploying with **Docker Stack** (Docker Swarm mode) using **replicas** and a **private registry**, you need to add the `--with-registry-auth` flag to ensure that registry credentials are properly distributed to all nodes in your swarm. + + Without this flag, worker nodes may fail to pull images from private registries, resulting in authentication errors like "no such image" or "docker authentication failed". + + This flag ensures that Docker shares the registry credentials with all swarm nodes during deployment, enabling them to authenticate and pull images from your private registry (GitHub Container Registry, Docker Hub private repos, etc.). + + - **Volumes**: To ensure data persistence across deployments, configure storage volumes for your application.