Skip to content

Commit f2ffd89

Browse files
support: single page (#23657)
## Description - Moves support information to dedicated page https://deploy-preview-23657--docsdocker.netlify.app/support/
1 parent 5ede496 commit f2ffd89

File tree

7 files changed

+186
-178
lines changed

7 files changed

+186
-178
lines changed

content/manuals/desktop/setup/vm-vdi.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ keywords: nested virtualization, Docker Desktop, windows, VM, VDI environment
44
title: Run Docker Desktop for Windows in a VM or VDI environment
55
linkTitle: VM or VDI environments
66
aliases:
7-
- /desktop/nested-virtualization/
8-
- /desktop/vm-vdi/
7+
- /desktop/nested-virtualization/
8+
- /desktop/vm-vdi/
99
weight: 30
1010
---
1111

@@ -44,11 +44,11 @@ quickstart](/offload/quickstart/).
4444
>
4545
> Support for running Docker Desktop on a virtual desktop is available to Docker Business customers, on VMware ESXi or Azure VMs only.
4646
47-
Docker support includes installing and running Docker Desktop within the VM, provided that nested virtualization is correctly enabled. The only hypervisors successfully tested are VMware ESXi and Azure, and there is no support for other VMs. For more information on Docker Desktop support, see [Get support](/manuals/desktop/troubleshoot-and-support/support.md).
47+
Docker support includes installing and running Docker Desktop within the VM, provided that nested virtualization is correctly enabled. The only hypervisors successfully tested are VMware ESXi and Azure, and there is no support for other VMs. For more information on Docker Desktop support, see [Get support](/manuals/support/_index.md).
4848

4949
For troubleshooting problems and intermittent failures that are outside of Docker's control, you should contact your hypervisor vendor. Each hypervisor vendor offers different levels of support. For example, Microsoft supports running nested Hyper-V both on-prem and on Azure, with some version constraints. This may not be the case for VMware ESXi.
5050

51-
Docker does not support running multiple instances of Docker Desktop on the same machine in a VM or VDI environment.
51+
Docker does not support running multiple instances of Docker Desktop on the same machine in a VM or VDI environment.
5252

5353
> [!TIP]
5454
>
@@ -83,14 +83,14 @@ If using Windows container mode, confirm that the Nutanix environment supports H
8383

8484
Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization):
8585

86-
- Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations.
86+
- Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations.
8787

88-
- Non-persistent VDI environments (Not supported): Docker Desktop does not support environments where the OS resets between sessions, requiring re-installation or reconfiguration each time.
88+
- Non-persistent VDI environments (Not supported): Docker Desktop does not support environments where the OS resets between sessions, requiring re-installation or reconfiguration each time.
8989

9090
### Support scope and responsibilities
9191

9292
For WSL 2-related issues, contact Nutanix support. For Docker Desktop-specific issues, contact Docker support.
9393

9494
## Additional resources
9595

96-
- [Docker Desktop on Microsoft Dev Box](/manuals/enterprise/enterprise-deployment/dev-box.md)
96+
- [Docker Desktop on Microsoft Dev Box](/manuals/enterprise/enterprise-deployment/dev-box.md)

content/manuals/desktop/troubleshoot-and-support/support.md

Lines changed: 0 additions & 124 deletions
This file was deleted.

content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,23 @@
11
---
2-
description: Understand how to diagnose and troubleshoot Docker Desktop, and how to
2+
description:
3+
Understand how to diagnose and troubleshoot Docker Desktop, and how to
34
check the logs.
45
keywords: Linux, Mac, Windows, troubleshooting, logs, issues, Docker Desktop
56
toc_max: 2
67
title: Troubleshoot Docker Desktop
78
linkTitle: Troubleshoot and diagnose
89
aliases:
9-
- /desktop/linux/troubleshoot/
10-
- /desktop/mac/troubleshoot/
11-
- /desktop/windows/troubleshoot/
12-
- /docker-for-mac/troubleshoot/
13-
- /mackit/troubleshoot/
14-
- /windows/troubleshoot/
15-
- /docker-for-win/troubleshoot/
16-
- /docker-for-windows/troubleshoot/
17-
- /desktop/troubleshoot/overview/
18-
- /desktop/troubleshoot/
19-
tags: [ Troubleshooting ]
10+
- /desktop/linux/troubleshoot/
11+
- /desktop/mac/troubleshoot/
12+
- /desktop/windows/troubleshoot/
13+
- /docker-for-mac/troubleshoot/
14+
- /mackit/troubleshoot/
15+
- /windows/troubleshoot/
16+
- /docker-for-win/troubleshoot/
17+
- /docker-for-windows/troubleshoot/
18+
- /desktop/troubleshoot/overview/
19+
- /desktop/troubleshoot/
20+
tags: [Troubleshooting]
2021
weight: 10
2122
---
2223

@@ -36,15 +37,15 @@ The **Troubleshooting** menu contains the following options:
3637
- **Reset Kubernetes cluster**. Select to delete all stacks and Kubernetes resources. For more information, see [Kubernetes](/manuals/desktop/settings-and-maintenance/settings.md#kubernetes).
3738

3839
- **Clean / Purge data**. This option resets all Docker data without a
39-
reset to factory defaults. Selecting this option results in the loss of existing settings.
40+
reset to factory defaults. Selecting this option results in the loss of existing settings.
4041

4142
- **Reset to factory defaults**: Choose this option to reset all options on
42-
Docker Desktop to their initial state, the same as when Docker Desktop was first installed.
43+
Docker Desktop to their initial state, the same as when Docker Desktop was first installed.
4344

4445
If you are a Mac or Linux user, you also have the option to **Uninstall** Docker Desktop from your system.
4546

4647
## Diagnose
47-
48+
4849
> [!TIP]
4950
>
5051
> If you do not find a solution in troubleshooting, browse the GitHub repositories or create a new issue:
@@ -59,22 +60,22 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
5960
2. When the diagnostics collection process is complete, select **Upload to get a Diagnostic ID**.
6061
3. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
6162
4. Use your diagnostics ID to get help:
62-
- 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.
63-
> [!NOTE]
64-
>
65-
> You must be signed in to Docker Desktop to access the support form. For information on what's covered as part of Docker Desktop support, see [Support](/manuals/desktop/troubleshoot-and-support/support.md).
66-
- If you don't have a paid Docker subscription, select **Report a Bug** to open a new Docker Desktop issue on GitHub. Complete the information required and ensure you add the diagnostic ID you copied in step three.
63+
- 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.
64+
> [!NOTE]
65+
>
66+
> You must be signed in to Docker Desktop to access the support form. For information on what's covered as part of Docker Desktop support, see [Support](/manuals/support/_index.md).
67+
- If you don't have a paid Docker subscription, select **Report a Bug** to open a new Docker Desktop issue on GitHub. Complete the information required and ensure you add the diagnostic ID you copied in step three.
6768

68-
### Diagnose from an error message
69+
### Diagnose from an error message
6970

7071
1. When an error message appears, select **Gather diagnostics**.
7172
2. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
7273
3. Use your diagnostics ID to get help:
73-
- 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.
74-
> [!NOTE]
75-
>
76-
> You must be signed in to Docker Desktop to access the support form. For information on what's covered as part of Docker Desktop support, see [Support](/manuals/desktop/troubleshoot-and-support/support.md).
77-
- If you don't have a paid Docker subscription, you can open a new Docker Desktop issue on GitHub for [Mac](https://github.com/docker/for-mac/issues), [Windows](https://github.com/docker/for-win/issues), or [Linux](https://github.com/docker/for-linux/issues). Complete the information required and ensure you add the diagnostic ID printed in step two.
74+
- 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.
75+
> [!NOTE]
76+
>
77+
> You must be signed in to Docker Desktop to access the support form. For information on what's covered as part of Docker Desktop support, see [Support](/manuals/support/_index.md).
78+
- If you don't have a paid Docker subscription, you can open a new Docker Desktop issue on GitHub for [Mac](https://github.com/docker/for-mac/issues), [Windows](https://github.com/docker/for-win/issues), or [Linux](https://github.com/docker/for-linux/issues). Complete the information required and ensure you add the diagnostic ID printed in step two.
7879

7980
### Diagnose from the terminal
8081

@@ -96,7 +97,7 @@ Docker Desktop cannot start.
9697
$ & "C:\Program Files\Docker\Docker\resources\com.docker.diagnose.exe" gather -upload
9798
```
9899

99-
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
100+
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
100101

101102
{{< /tab >}}
102103
{{< tab name="Mac" >}}
@@ -113,7 +114,7 @@ After the diagnostics have finished, the terminal displays your diagnostics ID a
113114
$ /Applications/Docker.app/Contents/MacOS/com.docker.diagnose gather -upload
114115
```
115116

116-
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
117+
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
117118

118119
{{< /tab >}}
119120
{{< tab name="Linux" >}}
@@ -130,7 +131,7 @@ After the diagnostics have finished, the terminal displays your diagnostics ID a
130131
$ /opt/docker-desktop/bin/com.docker.diagnose gather -upload
131132
```
132133

133-
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
134+
After the diagnostics have finished, the terminal displays your diagnostics ID and the path to the diagnostics file. The diagnostics ID is composed of your user ID and a timestamp. For example `BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051`.
134135

135136
{{< /tab >}}
136137
{{< /tabs >}}
@@ -144,7 +145,7 @@ To view the contents of the diagnostic file:
144145

145146
```powershell
146147
$ Expand-Archive -LiteralPath "C:\Users\testUser\AppData\Local\Temp\5DE9978A-3848-429E-8776-950FC869186F\20230607101602.zip" -DestinationPath "C:\Users\testuser\AppData\Local\Temp\5DE9978A-3848-429E-8776-950FC869186F\20230607101602"
147-
```
148+
```
148149

149150
2. Open the file in your preferred text editor. Run:
150151

@@ -176,7 +177,7 @@ $ unzip –l /tmp/<your-diagnostics-ID>.zip
176177
#### Use your diagnostics ID to get help
177178

178179
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.
179-
180+
180181
If you don't have a paid Docker subscription, create an issue on GitHub:
181182

182183
- [For Linux](https://github.com/docker/desktop-linux/issues)
@@ -262,3 +263,4 @@ to learn how to view the Docker Daemon logs.
262263
- View specific [troubleshoot topics](topics.md).
263264
- View information on [known issues](known-issues.md)
264265
- [Fix "Docker.app is damaged" on macOS](mac-damaged-dialog.md) - Resolve macOS installation issues
266+
- [Get support for Docker products](/manuals/support/_index.md)

content/manuals/desktop/troubleshoot-and-support/troubleshoot/mac-damaged-dialog.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ Follow these steps to resolve the issue:
2828
### Step one: Quit third-party software
2929

3030
Close any applications that might call Docker in the background:
31+
3132
- Visual Studio Code and other IDEs
3233
- Terminal applications
3334
- Agent apps or development tools
@@ -47,10 +48,11 @@ Follow the instructions in the [macOS installation guide](/manuals/desktop/setup
4748
If you continue to see the "damaged" dialog after following the recovery steps:
4849

4950
1. Gather diagnostics using the terminal. Follow the instructions in [Diagnose from the terminal](/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md#diagnose-from-the-terminal).
51+
5052
- Note down the your diagnostics ID displayed in the terminal after running diagnostics.
5153

5254
2. Get help:
53-
- If you have a paid Docker subscription, [contact support](/manuals/desktop/troubleshoot-and-support/support.md) and include your diagnostics ID
55+
- If you have a paid Docker subscription, [contact support](/manuals/support/_index.md) and include your diagnostics ID
5456
- For community users, [open an issue on GitHub](https://github.com/docker/for-mac/issues) and include your diagnostics ID
5557

5658
## Prevention

0 commit comments

Comments
 (0)