From 7da98723f26ef7007118ab9e15f667613ca3769d Mon Sep 17 00:00:00 2001
From: aevesdocker <allie.sadler@docker.com>
Date: Tue, 3 Feb 2026 11:18:06 +0000
Subject: [PATCH] Desktop: new CLI command

---
 .../manuals/desktop/features/desktop-cli.md   |  1 +
 .../troubleshoot/_index.md                    |  4 ++++
 .../reference/cli/docker/desktop/diagnose.md  |  8 +++++++
 data/desktop-cli/docker_desktop_diagnose.yaml | 22 +++++++++++++++++++
 data/summary.yaml                             |  2 ++
 5 files changed, 37 insertions(+)
 create mode 100644 content/reference/cli/docker/desktop/diagnose.md
 create mode 100644 data/desktop-cli/docker_desktop_diagnose.yaml

diff --git a/content/manuals/desktop/features/desktop-cli.md b/content/manuals/desktop/features/desktop-cli.md
index 1bc37bfba099..3a3a18bcbbaf 100644
--- a/content/manuals/desktop/features/desktop-cli.md
+++ b/content/manuals/desktop/features/desktop-cli.md
@@ -37,5 +37,6 @@ docker desktop COMMAND [OPTIONS]
 | `enable`             | Enable a feature                         | 
 | `version`            | Show the Docker Desktop CLI plugin version information |
 | `kubernetes`         | List Kubernetes images used by Docker Desktop or restart the cluster. Available with Docker Desktop version 4.44 and later.          |
+| `diagnose`.          | Diagnose Docker Desktop and upload the diagnostics. Available with Docker Desktop 4.60 and later. |
 
 For more details on each command, see the [Docker Desktop CLI reference](/reference/cli/docker/desktop/_index.md).
diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
index 41e4cc772181..422cc19dea7f 100644
--- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
+++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
@@ -132,6 +132,10 @@ After the diagnostics have finished, the terminal displays your diagnostics ID a
 {{< /tab >}}
 {{< /tabs >}}
 
+> [!TIP]
+>
+> You can also use the [`docker desktop diagnose` command](/manuals/desktop/features/desktop-cli.md) to diagnose Docker Desktop and upload the diagnostics ID.
+
 To view the contents of the diagnostic file:
 
 {{< tabs group="os" >}}
diff --git a/content/reference/cli/docker/desktop/diagnose.md b/content/reference/cli/docker/desktop/diagnose.md
new file mode 100644
index 000000000000..80b23bbd5600
--- /dev/null
+++ b/content/reference/cli/docker/desktop/diagnose.md
@@ -0,0 +1,8 @@
+---
+datafolder: desktop-cli
+datafile: docker_desktop_diagnose
+title: docker desktop diagnose
+layout: cli
+---
+
+{{< summary-bar feature_name="Docker Desktop CLI diagnose" >}}
\ No newline at end of file
diff --git a/data/desktop-cli/docker_desktop_diagnose.yaml b/data/desktop-cli/docker_desktop_diagnose.yaml
new file mode 100644
index 000000000000..9e7fddea2a78
--- /dev/null
+++ b/data/desktop-cli/docker_desktop_diagnose.yaml
@@ -0,0 +1,22 @@
+command: docker desktop diagnose
+short: Diagnose Docker Desktop issues
+usage: docker desktop diagnose [OPTIONS]
+pname: docker desktop diagnose
+plink: docker_desktop_diagnose.yaml
+options:
+    - option: upload
+      shorthand: u
+      value_type: bool
+      default_value: "false"
+      description: Uploads the diagnostic ID.
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
+deprecated: false
+hidden: false
+experimental: false
+experimentalcli: false
+kubernetes: false
\ No newline at end of file
diff --git a/data/summary.yaml b/data/summary.yaml
index 8fd6147eaa16..d845c1c52d19 100644
--- a/data/summary.yaml
+++ b/data/summary.yaml
@@ -169,6 +169,8 @@ Docker Desktop CLI logs:
   requires: Docker Desktop 4.39 and later
 Docker Desktop CLI kubernetes:
   requires: Docker Desktop 4.44 and later
+Docker Desktop CLI diagnose:
+  requires: Docker Desktop 4.60 and later
 Docker Hardened Images:
   subscription: [Docker Hardened Images Enterprise]
 Docker Init: