From c28afcb4131da455e3669320bf5886b65eb69e34 Mon Sep 17 00:00:00 2001
From: Hannah Cooper <hannah.cooper@portainer.io>
Date: Wed, 12 Nov 2025 20:07:52 +0000
Subject: [PATCH] GITBOOK-20: Known issues page - docker 29 compatibility

---
 SUMMARY.md                                                   | 1 +
 .../known-compatibility-issues-with-docker-engine-29.0.0.md  | 5 +++++
 2 files changed, 6 insertions(+)
 create mode 100644 faqs/known-issues/known-compatibility-issues-with-docker-engine-29.0.0.md

diff --git a/SUMMARY.md b/SUMMARY.md
index bedee2e8..1d596fa7 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -411,6 +411,7 @@
   * [MicroK8s Known Issues](faqs/known-issues/microk8s-known-issues.md)
   * ["Unauthorized" error when pushing images to ACR with Service Principal account](faqs/known-issues/unauthorized-error-when-pushing-images-to-acr-with-service-principal-account.md)
   * ["Invalid certificate file" error when browsing empty Azure Container Registry](faqs/known-issues/invalid-certificate-file-error-when-browsing-empty-azure-container-registry.md)
+  * [Known compatibility issues with Docker Engine 29.0.0](faqs/known-issues/known-compatibility-issues-with-docker-engine-29.0.0.md)
 * [Getting support](faqs/getting-support/README.md)
   * [Where can I find the documentation for Portainer?](faqs/getting-support/where-can-i-find-the-documentation-for-portainer.md)
   * [How to get support for Community Edition and 5 Nodes Free Users](faqs/getting-support/how-to-get-support-for-community-edition-and-5-nodes-free-users.md)
diff --git a/faqs/known-issues/known-compatibility-issues-with-docker-engine-29.0.0.md b/faqs/known-issues/known-compatibility-issues-with-docker-engine-29.0.0.md
new file mode 100644
index 00000000..ae9ef83f
--- /dev/null
+++ b/faqs/known-issues/known-compatibility-issues-with-docker-engine-29.0.0.md
@@ -0,0 +1,5 @@
+# Known compatibility issues with Docker Engine 29.0.0
+
+The latest Docker Engine 29.0.0 introduces breaking changes that prevent current Portainer versions from connecting to Docker Standalone environments. Until support is added, please keep using the Docker versions listed on our [requirements page](../../start/requirements-and-prerequisites.md).
+
+A temporary workaround has been found by our community and is detailed under [GitHub Issue 12925](https://github.com/portainer/portainer/issues/12925#issuecomment-3516549977).