centersl/docker-docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-03-27 14:28:47 +07:00
Code Issues Packages Projects Releases Wiki Activity

docs: address issue #24270 (#24271)

Browse Source 
## Summary
Added timing expectations for diagnostics gathering to help users
understand the process may take several minutes.

## Changes
- Added NOTE callouts in three diagnostics sections explaining that
gathering diagnostics may take several minutes
- Advised users not to close Docker Desktop or terminal while
diagnostics are being collected
- Consistent messaging across "Diagnose from the app", "Diagnose from an
error message", and "Diagnose from the terminal" sections

Fixes #24270

---
🤖 Generated with [cagent](https://github.com/docker/cagent)

Co-authored-by: aevesdocker <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
2026-03-04 13:59:55 +00:00
committed by GitHub
parent 5f9216ccc3
commit 3884c166de
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
View File

@@ -53,6 +53,9 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
### Diagnose from the app
1. From **Troubleshoot**, select **Get support**. This opens the in-app Support page and starts collecting the diagnostics.
> [!NOTE]
>
> Gathering diagnostics may take several minutes. Don't close Docker Desktop while the diagnostics are being collected.
2. When the diagnostics collection process is complete, select **Upload to get a Diagnostic ID**.
3. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
4. Use your diagnostics ID to get help:
@@ -65,6 +68,9 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
### Diagnose from an error message
1. When an error message appears, select **Gather diagnostics**.
> [!NOTE]
>
> Gathering diagnostics may take several minutes. Don't close Docker Desktop while the diagnostics are being collected.
2. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
3. Use your diagnostics ID to get help:
- If you have a paid Docker subscription, select **Contact support**. This opens the Docker Desktop support form. Fill in the information required and add the ID you copied in step three to the **Diagnostics ID field**. Then, select **Submit ticket** to request Docker Desktop support.
@@ -78,6 +84,10 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
In some cases, it's useful to run the diagnostics yourself, for instance, if
Docker Desktop cannot start.
> [!NOTE]
>
> Gathering diagnostics may take several minutes. Wait for the process to complete before closing the terminal.
{{< tabs group="os" >}}
{{< tab name="Windows" >}}