From 8c5b180c45d27015629b1f00956fb12936c41e88 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Tue, 4 Nov 2025 14:47:41 -0500 Subject: [PATCH 1/7] support: add severity levels --- .../desktop/troubleshoot-and-support/support.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/content/manuals/desktop/troubleshoot-and-support/support.md b/content/manuals/desktop/troubleshoot-and-support/support.md index 7a0b24ec5369..38b06d4d7ae0 100644 --- a/content/manuals/desktop/troubleshoot-and-support/support.md +++ b/content/manuals/desktop/troubleshoot-and-support/support.md @@ -28,6 +28,16 @@ Support response times and availability vary by subscription tier: For detailed support features and response times, see [Docker Pricing](https://www.docker.com/pricing/). +### Support severity + +Classify support requests by severity levels: + +| Severity | Level | Description | +| :--------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Severity 1 | Critical | Full outage or complete loss of service. Docker is completely unavailable or a critical business function is blocked with no workaround available. | +| Severity 2 | High | Major disruption to service. Docker is experiencing significant performance degradation or a major feature is unavailable, impacting multiple users or critical workflows. | +| Severity 3 | Medium | User issue with workaround available. Docker has a functional limitation or non-critical issue that can be circumvented with an alternative approach or temporary solution. | + ### Community support All Docker users can seek support through the following resources, where Docker or the community respond on a best effort basis: From cc2205df7fa5b2db54c429868fa5bcee3fec5593 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Thu, 6 Nov 2025 09:52:26 -0500 Subject: [PATCH 2/7] update definitions --- .../desktop/troubleshoot-and-support/support.md | 10 +++++----- hugo_stats.json | 5 +++++ 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/content/manuals/desktop/troubleshoot-and-support/support.md b/content/manuals/desktop/troubleshoot-and-support/support.md index 38b06d4d7ae0..da48c3b44fd3 100644 --- a/content/manuals/desktop/troubleshoot-and-support/support.md +++ b/content/manuals/desktop/troubleshoot-and-support/support.md @@ -32,11 +32,11 @@ For detailed support features and response times, see [Docker Pricing](https://w Classify support requests by severity levels: -| Severity | Level | Description | -| :--------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Severity 1 | Critical | Full outage or complete loss of service. Docker is completely unavailable or a critical business function is blocked with no workaround available. | -| Severity 2 | High | Major disruption to service. Docker is experiencing significant performance degradation or a major feature is unavailable, impacting multiple users or critical workflows. | -| Severity 3 | Medium | User issue with workaround available. Docker has a functional limitation or non-critical issue that can be circumvented with an alternative approach or temporary solution. | +| Severity | Level | Impact | Description | +| :--------- | :------- | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Severity 1 | Critical | Widespread or company-wide service outage | A defect or outage that causes a complete loss of core functionality for many customers at once (systemic issue), or all users within a single customer organization. Business operations are halted and no workaround is available. | +| Severity 2 | High | Team or department-level impact | A defect or outage that prevents a significant subset of users within one organization (e.g., a team, department, or site) from using core functionality. The issue has severe business impact and no workaround exists. | +| Severity 3 | Medium | Individual user impact | A problem causing partial or non-critical loss of use of functionality for an individual user or small group. Business operations continue, often with a workaround available, but productivity is reduced. | ### Community support diff --git a/hugo_stats.json b/hugo_stats.json index 23fc99e1a492..2af0050fd096 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -37,6 +37,8 @@ "Compliant", "Custom-builder", "DNS-resolution", + "DSOS-Legacy-DVP-programs", + "DVP-program", "Debian", "Diff", "Docker-Build-Cloud", @@ -112,8 +114,10 @@ "Old-Dockerfile", "Other-providers", "PHP", + "Post-rendering", "PowerShell", "PowerShell-CLI", + "Pre-rendering", "Python", "RHEL-8", "RHEL-9", @@ -134,6 +138,7 @@ "Teams", "Testcontainers-Cloud", "TypeScript", + "Typescript", "Ubuntu", "Ubuntu/Debian", "Unix-pipe", From 5c30b7700a834998270ea43bdc7c7c838ac623a4 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Mon, 10 Nov 2025 09:22:42 -0500 Subject: [PATCH 3/7] simplify table --- .../desktop/troubleshoot-and-support/support.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/manuals/desktop/troubleshoot-and-support/support.md b/content/manuals/desktop/troubleshoot-and-support/support.md index da48c3b44fd3..bab1836ccaf4 100644 --- a/content/manuals/desktop/troubleshoot-and-support/support.md +++ b/content/manuals/desktop/troubleshoot-and-support/support.md @@ -32,11 +32,11 @@ For detailed support features and response times, see [Docker Pricing](https://w Classify support requests by severity levels: -| Severity | Level | Impact | Description | -| :--------- | :------- | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Severity 1 | Critical | Widespread or company-wide service outage | A defect or outage that causes a complete loss of core functionality for many customers at once (systemic issue), or all users within a single customer organization. Business operations are halted and no workaround is available. | -| Severity 2 | High | Team or department-level impact | A defect or outage that prevents a significant subset of users within one organization (e.g., a team, department, or site) from using core functionality. The issue has severe business impact and no workaround exists. | -| Severity 3 | Medium | Individual user impact | A problem causing partial or non-critical loss of use of functionality for an individual user or small group. Business operations continue, often with a workaround available, but productivity is reduced. | +| Level | Description | +| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Critical | Widespread or company-wide service outage affecting many customers or all users within a single organization. Business operations are halted with no workaround available. | +| High | Team or department-level impact preventing significant users from accessing core functionality. Severe business impact with no workaround exists. | +| Medium | Individual user or small group impact causing partial loss of functionality. Business operations continue, often with workarounds available but reduced productivity. | ### Community support From d6459a8f1d6963de3a1aad1f7d5faf65de908295 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Mon, 10 Nov 2025 13:57:15 -0500 Subject: [PATCH 4/7] move support content to one page --- .../troubleshoot-and-support/support.md | 134 ------------------ content/manuals/subscription/details.md | 17 +-- content/manuals/support/_index.md | 133 +++++++++++++++++ 3 files changed, 135 insertions(+), 149 deletions(-) delete mode 100644 content/manuals/desktop/troubleshoot-and-support/support.md create mode 100644 content/manuals/support/_index.md diff --git a/content/manuals/desktop/troubleshoot-and-support/support.md b/content/manuals/desktop/troubleshoot-and-support/support.md deleted file mode 100644 index bab1836ccaf4..000000000000 --- a/content/manuals/desktop/troubleshoot-and-support/support.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -description: See what support is available for Docker Desktop -keywords: Support, Docker Desktop, Linux, Mac, Windows -title: Get support for Docker Desktop -weight: 20 -aliases: - - /desktop/support/ - - /support/ ---- - -> [!NOTE] -> -> Docker Desktop offers support for developers with a [Pro, Team, or Business subscription](https://www.docker.com/pricing?utm_source=docker&utm_medium=webreferral&utm_campaign=docs_driven_upgrade_desktop_support). - -## Support options - -All Docker Pro, Team, and Business subscribers receive email support for Docker Desktop, including help with account management, billing, configuration, installation, and usage issues. - -Support response times and availability vary by subscription tier: - -- Docker Pro: 3 business day response -- Docker Team: 2 business day response, 24×5 availability -- Docker Business: 1 business day response, 24×5 availability - -> [!NOTE] -> -> Premium Support with faster response times and 24×7 availability is available as an add-on for Docker Business subscribers. - -For detailed support features and response times, see [Docker Pricing](https://www.docker.com/pricing/). - -### Support severity - -Classify support requests by severity levels: - -| Level | Description | -| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Critical | Widespread or company-wide service outage affecting many customers or all users within a single organization. Business operations are halted with no workaround available. | -| High | Team or department-level impact preventing significant users from accessing core functionality. Severe business impact with no workaround exists. | -| Medium | Individual user or small group impact causing partial loss of functionality. Business operations continue, often with workarounds available but reduced productivity. | - -### Community support - -All Docker users can seek support through the following resources, where Docker or the community respond on a best effort basis: - -- [Docker Desktop for Windows GitHub repo](https://github.com/docker/for-win) -- [Docker Desktop for Mac GitHub repo](https://github.com/docker/for-mac) -- [Docker Desktop for Linux GitHub repo](https://github.com/docker/desktop-linux) -- [Docker Community Forums](https://forums.docker.com/) -- [Docker Community Slack](http://dockr.ly/comm-slack) - -## How do I get Docker Desktop support? - -> [!TIP] -> -> Before reaching out for support, follow the appropriate [Diagnose steps](/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md#diagnose) in the troubleshooting documentation. - -If you have a paid Docker subscription, you can [contact the Support team](https://hub.docker.com/support/contact/). - -### What support can I get? - -- Account management related issues -- Automated builds -- Basic product 'how to' questions -- Billing or subscription issues -- Configuration issues -- Desktop installation issues - - Installation crashes - - Failure to launch Docker Desktop on first run -- Desktop update issues -- Sign-in issues in both the command line interface and Docker Hub user interface -- Push or pull issues, including rate limiting -- Usage issues - - Crash closing software - - Docker Desktop not behaving as expected - -For Windows users, you can also request support on: - -- Turning on virtualization in BIOS -- Turning on Windows features -- Running inside [certain VM or VDI environments](/manuals/desktop/setup/vm-vdi.md) (Docker Business customers only) - -### What is not supported? - -Docker Desktop excludes support for the following types of issues: - -- Use on or in conjunction with hardware or software other than that specified in the applicable documentation -- Running on unsupported operating systems, including beta/preview versions of operating systems -- Running containers of a different architecture using emulation -- Support for Docker Engine, Docker CLI, or other bundled Linux components -- Support for Kubernetes -- Features labeled as experimental -- System/Server administration activities -- Supporting Desktop as a production runtime -- Scale deployment/multi-machine installation of Desktop -- Routine product maintenance (data backup, cleaning disk space and configuring log rotation) -- Third-party applications not provided by Docker -- Altered or modified Docker software -- Defects in the Docker software due to hardware malfunction, abuse, or improper use -- Any version of the Docker software other than the latest version -- Reimbursing and expenses spent for third-party services not provided by Docker -- Docker support excludes training, customization, and integration -- Running multiple instances of Docker Desktop on a single machine - -> [!NOTE] -> -> Support for [running Docker Desktop in a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md) is only available to Docker Business customers. - -### What versions are supported? - -For Docker Business customers, Docker offers support for versions up to six months older than the latest version, although any fixes will be on the latest version. - -For Pro and Team customers, Docker only offers support for the latest version of Docker Desktop. If you are running an older version, Docker may ask you to update before investigating your support request. - -### How many machines can I get support for Docker Desktop on? - -As a Pro user you can get support for Docker Desktop on a single machine. -As a Team, you can get support for Docker Desktop for the number of machines equal to the number of seats as part of your subscription. - -### What operating systems are supported? - -Docker Desktop is available for Mac, Linux, and Windows. The supported version information can be found on the following pages: - -- [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements) -- [Windows system requirements](/manuals/desktop/setup/install/windows-install.md#system-requirements) -- [Linux system requirements](/manuals/desktop/setup/install/linux/_index.md#system-requirements) - -### How is personal diagnostic data handled in Docker Desktop when I'm getting support? - -When uploading diagnostics to help Docker with investigating issues, the uploaded diagnostics bundle may contain personal data such as usernames and IP addresses. The diagnostics bundles are only accessible to Docker, Inc. -employees who are directly involved in diagnosing Docker Desktop issues. - -By default, Docker, Inc. will delete uploaded diagnostics bundles after 30 days. You may also request the removal of a diagnostics bundle by either specifying the diagnostics ID or via your GitHub ID (if the diagnostics ID is mentioned in a GitHub issue). Docker, Inc. will only use the data in the diagnostics bundle to investigate specific user issues but may derive high-level (non personal) metrics such as the rate of issues from it. - -For more information, see [Docker Data Processing Agreement](https://www.docker.com/legal/data-processing-agreement). diff --git a/content/manuals/subscription/details.md b/content/manuals/subscription/details.md index de4a249c80b1..53024a7a81f9 100644 --- a/content/manuals/subscription/details.md +++ b/content/manuals/subscription/details.md @@ -353,18 +353,5 @@ A dedicated Docker account manager handles setup and management for Docker Busin ## Support -All Docker Pro, Team, and Business subscribers receive email support for their subscriptions, including help with account management, billing, configuration, installation, and usage issues. - -Support response times and availability vary by subscription tier: - -- Docker Pro: 3 business day response -- Docker Team: 2 business day response, 24×5 availability -- Docker Business: 1 business day response, 24×5 availability - -> [!NOTE] -> -> Premium Support with faster response times and 24×7 availability is available as an add-on for Docker Business subscribers. - -For detailed support features and response times, see [Docker Pricing](https://www.docker.com/pricing/). - -All Docker users can also access community support through the [Docker Community Forums](https://forums.docker.com/) and [Docker Community Slack](https://dockr.ly/comm-slack). +All paid subscriptions come with Docker support. For more information, see +[Get support for Docker products](/manuals/support/_index.md). diff --git a/content/manuals/support/_index.md b/content/manuals/support/_index.md new file mode 100644 index 000000000000..17a05817ab68 --- /dev/null +++ b/content/manuals/support/_index.md @@ -0,0 +1,133 @@ +--- +title: Get support for Docker products +linkTitle: Support +description: Learn about support options for Docker products including paid subscriptions and community resources +keywords: support, help, docker desktop, subscriptions, community, troubleshooting +weight: 5 +params: + sidebar: + group: Platform +--- + +Docker offers multiple support channels depending on your subscription level and needs. + +## Paid subscription support + +All Docker Pro, Team, and Business subscribers receive email support for Docker products. + +### Support response times + +- Docker Pro: 3 business day response +- Docker Team: 2 business day response, 24×5 availability +- Docker Business: 1 business day response, 24×5 availability + +> [!NOTE] +> +> Premium Support with faster response times and 24×7 availability is available as an add-on for Docker Business subscribers. + +For detailed support features and response times, see [Docker Pricing](https://www.docker.com/pricing/). + +### Support severity levels + +| Level | Description | +| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Critical | Widespread or company-wide service outage affecting many customers or all users within a single organization. Business operations are halted with no workaround available. | +| High | Team or department-level impact preventing significant users from accessing core functionality. Severe business impact with no workaround exists. | +| Medium | Individual user or small group impact causing partial loss of functionality. Business operations continue, often with workarounds available but reduced productivity. | + +### Request support + +> [!TIP] +> +> Before reaching out for support, review the troubleshooting documentation for your product. + +If you have a paid Docker subscription, [contact the Support team](https://hub.docker.com/support/contact/). + +## Community support + +All Docker users can seek support through community resources, where Docker or the community respond on a best effort basis: + +- [Docker Community Forums](https://forums.docker.com/) +- [Docker Community Slack](http://dockr.ly/comm-slack) + +## Docker Desktop support + +### Scope of support + +{{< tabs >}} +{{< tab name="Covered">}} + +Docker Desktop support includes: + +- Account management and billing +- Configuration and installation issues +- Desktop updates +- Sign-in issues +- Push or pull issues, including rate limiting +- Application crashes or unexpected behavior +- Automated builds +- Basic product 'how to' questions + +**Windows-specific:** + +- Turning on virtualization in BIOS +- Turning on Windows features +- Running inside [certain VM or VDI environments](/manuals/desktop/setup/vm-vdi.md) (Docker Business only) + +{{< /tab >}} +{{< tab name="Not covered">}} + +Docker Desktop support excludes: + +- Unsupported operating systems, including beta/preview versions +- Running containers of a different architecture using emulation +- Docker Engine, Docker CLI, or other bundled Linux components +- Kubernetes +- Features labeled as experimental +- System/Server administration activities +- Desktop as a production runtime +- Scale deployment/multi-machine installation +- Routine product maintenance (data backup, disk space, log rotation) +- Third-party applications not provided by Docker +- Altered or modified Docker software +- Hardware malfunction, abuse, or improper use +- Versions older than the latest release (except Docker Business) +- Training, customization, and integration +- Running multiple instances on a single machine + +> [!NOTE] +> +> Support for [running Docker Desktop in a VM or VDI environment](/manuals/desktop/setup/vm-vdi.md) is only available to Docker Business customers. + +{{< /tab >}} +{{< /tabs >}} + +### Supported versions + +- Docker Business: Versions up to six months older than the latest version (fixes applied to latest version only) +- Docker Pro and Team: Latest version only + +### Number of machines + +- Docker Pro: One machine +- Docker Team: Number of machines equal to subscription seats + +### Supported operating systems + +- [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements) +- [Windows system requirements](/manuals/desktop/setup/install/windows-install.md#system-requirements) +- [Linux system requirements](/manuals/desktop/setup/install/linux/_index.md#system-requirements) + +### Community resources + +- [Docker Desktop for Windows](https://github.com/docker/for-win) +- [Docker Desktop for Mac](https://github.com/docker/for-mac) +- [Docker Desktop for Linux](https://github.com/docker/desktop-linux) + +### Diagnostic data and privacy + +When uploading diagnostics, the bundle may contain personal data such as usernames and IP addresses. Diagnostics bundles are only accessible to Docker, Inc. employees directly involved in diagnosing issues. + +By default, Docker, Inc. deletes uploaded diagnostics bundles after 30 days. You may request removal of a diagnostics bundle by specifying the diagnostics ID or your GitHub ID. Docker, Inc. only uses the data to investigate specific user issues but may derive high-level (non-personal) metrics. + +For more information, see [Docker Data Processing Agreement](https://www.docker.com/legal/data-processing-agreement). From 34613faa4ce842b780de67c17913af0414302ad4 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Mon, 10 Nov 2025 14:02:23 -0500 Subject: [PATCH 5/7] fix broken links --- content/manuals/desktop/setup/vm-vdi.md | 14 ++--- .../troubleshoot/_index.md | 63 ++++++++++--------- .../troubleshoot/mac-damaged-dialog.md | 4 +- 3 files changed, 42 insertions(+), 39 deletions(-) diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index e99c02c5e4e3..27c797e24824 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -4,8 +4,8 @@ keywords: nested virtualization, Docker Desktop, windows, VM, VDI environment title: Run Docker Desktop for Windows in a VM or VDI environment linkTitle: VM or VDI environments aliases: - - /desktop/nested-virtualization/ - - /desktop/vm-vdi/ + - /desktop/nested-virtualization/ + - /desktop/vm-vdi/ weight: 30 --- @@ -46,11 +46,11 @@ quickstart](/offload/quickstart/). > > Support for running Docker Desktop on a virtual desktop is available to Docker Business customers, on VMware ESXi or Azure VMs only. -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). +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). 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. -Docker does not support running multiple instances of Docker Desktop on the same machine in a VM or VDI environment. +Docker does not support running multiple instances of Docker Desktop on the same machine in a VM or VDI environment. > [!TIP] > @@ -85,9 +85,9 @@ If using Windows container mode, confirm that the Nutanix environment supports H Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization): - - Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations. +- Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations. - - 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. +- 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. ### Support scope and responsibilities @@ -95,4 +95,4 @@ For WSL 2-related issues, contact Nutanix support. For Docker Desktop-specific i ## Additional resources -- [Docker Desktop on Microsoft Dev Box](/manuals/enterprise/enterprise-deployment/dev-box.md) \ No newline at end of file +- [Docker Desktop on Microsoft Dev Box](/manuals/enterprise/enterprise-deployment/dev-box.md) diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md index 042caccb8e34..bbb789ff1939 100644 --- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md +++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md @@ -1,22 +1,23 @@ --- -description: Understand how to diagnose and troubleshoot Docker Desktop, and how to +description: + Understand how to diagnose and troubleshoot Docker Desktop, and how to check the logs. keywords: Linux, Mac, Windows, troubleshooting, logs, issues, Docker Desktop toc_max: 2 title: Troubleshoot Docker Desktop linkTitle: Troubleshoot and diagnose aliases: - - /desktop/linux/troubleshoot/ - - /desktop/mac/troubleshoot/ - - /desktop/windows/troubleshoot/ - - /docker-for-mac/troubleshoot/ - - /mackit/troubleshoot/ - - /windows/troubleshoot/ - - /docker-for-win/troubleshoot/ - - /docker-for-windows/troubleshoot/ - - /desktop/troubleshoot/overview/ - - /desktop/troubleshoot/ -tags: [ Troubleshooting ] + - /desktop/linux/troubleshoot/ + - /desktop/mac/troubleshoot/ + - /desktop/windows/troubleshoot/ + - /docker-for-mac/troubleshoot/ + - /mackit/troubleshoot/ + - /windows/troubleshoot/ + - /docker-for-win/troubleshoot/ + - /docker-for-windows/troubleshoot/ + - /desktop/troubleshoot/overview/ + - /desktop/troubleshoot/ +tags: [Troubleshooting] weight: 10 --- @@ -36,15 +37,15 @@ The **Troubleshooting** menu contains the following options: - **Reset Kubernetes cluster**. Select to delete all stacks and Kubernetes resources. For more information, see [Kubernetes](/manuals/desktop/settings-and-maintenance/settings.md#kubernetes). - **Clean / Purge data**. This option resets all Docker data without a -reset to factory defaults. Selecting this option results in the loss of existing settings. + reset to factory defaults. Selecting this option results in the loss of existing settings. - **Reset to factory defaults**: Choose this option to reset all options on -Docker Desktop to their initial state, the same as when Docker Desktop was first installed. + Docker Desktop to their initial state, the same as when Docker Desktop was first installed. If you are a Mac or Linux user, you also have the option to **Uninstall** Docker Desktop from your system. ## Diagnose - + > [!TIP] > > 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 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: - - 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. - > [!NOTE] - > - > 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). - - 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. + - 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. + > [!NOTE] + > + > 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). + - 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. -### Diagnose from an error message +### Diagnose from an error message 1. When an error message appears, select **Gather diagnostics**. 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. - > [!NOTE] - > - > 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). - - 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. + - 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. + > [!NOTE] + > + > 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). + - 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. ### Diagnose from the terminal @@ -96,7 +97,7 @@ Docker Desktop cannot start. $ & "C:\Program Files\Docker\Docker\resources\com.docker.diagnose.exe" gather -upload ``` -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`. +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`. {{< /tab >}} {{< tab name="Mac" >}} @@ -113,7 +114,7 @@ After the diagnostics have finished, the terminal displays your diagnostics ID a $ /Applications/Docker.app/Contents/MacOS/com.docker.diagnose gather -upload ``` -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`. +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`. {{< /tab >}} {{< tab name="Linux" >}} @@ -130,7 +131,7 @@ After the diagnostics have finished, the terminal displays your diagnostics ID a $ /opt/docker-desktop/bin/com.docker.diagnose gather -upload ``` -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`. +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`. {{< /tab >}} {{< /tabs >}} @@ -144,7 +145,7 @@ To view the contents of the diagnostic file: ```powershell $ 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" - ``` + ``` 2. Open the file in your preferred text editor. Run: @@ -176,7 +177,7 @@ $ unzip –l /tmp/.zip #### 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. - + If you don't have a paid Docker subscription, create an issue on GitHub: - [For Linux](https://github.com/docker/desktop-linux/issues) diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/mac-damaged-dialog.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/mac-damaged-dialog.md index 2efd3e04b2e1..5ae58bf26589 100644 --- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/mac-damaged-dialog.md +++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/mac-damaged-dialog.md @@ -28,6 +28,7 @@ Follow these steps to resolve the issue: ### Step one: Quit third-party software Close any applications that might call Docker in the background: + - Visual Studio Code and other IDEs - Terminal applications - Agent apps or development tools @@ -47,10 +48,11 @@ Follow the instructions in the [macOS installation guide](/manuals/desktop/setup If you continue to see the "damaged" dialog after following the recovery steps: 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). + - Note down the your diagnostics ID displayed in the terminal after running diagnostics. 2. Get help: - - If you have a paid Docker subscription, [contact support](/manuals/desktop/troubleshoot-and-support/support.md) and include your diagnostics ID + - If you have a paid Docker subscription, [contact support](/manuals/support/_index.md) and include your diagnostics ID - For community users, [open an issue on GitHub](https://github.com/docker/for-mac/issues) and include your diagnostics ID ## Prevention From 40a844c7c562e7946b5ef4f5135635d551a1b8d9 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Tue, 11 Nov 2025 12:00:02 -0500 Subject: [PATCH 6/7] usha feedback --- .../desktop/troubleshoot-and-support/troubleshoot/_index.md | 1 + content/manuals/support/_index.md | 2 ++ 2 files changed, 3 insertions(+) diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md index bbb789ff1939..f6ce47aba6fb 100644 --- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md +++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md @@ -263,3 +263,4 @@ to learn how to view the Docker Daemon logs. - View specific [troubleshoot topics](topics.md). - View information on [known issues](known-issues.md) - [Fix "Docker.app is damaged" on macOS](mac-damaged-dialog.md) - Resolve macOS installation issues +- [Get support for Docker products](/manuals/support/_index.md) diff --git a/content/manuals/support/_index.md b/content/manuals/support/_index.md index 17a05817ab68..5759f174889f 100644 --- a/content/manuals/support/_index.md +++ b/content/manuals/support/_index.md @@ -52,6 +52,8 @@ All Docker users can seek support through community resources, where Docker or t ## Docker Desktop support +Docker Desktop support is available with a paid subscription. + ### Scope of support {{< tabs >}} From 37e91b3d22da308b184b6d32232e03ef1f6108b0 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Wed, 12 Nov 2025 09:13:46 -0500 Subject: [PATCH 7/7] add line about business machines --- content/manuals/support/_index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/manuals/support/_index.md b/content/manuals/support/_index.md index 5759f174889f..f5276a1884c8 100644 --- a/content/manuals/support/_index.md +++ b/content/manuals/support/_index.md @@ -113,6 +113,7 @@ Docker Desktop support excludes: - Docker Pro: One machine - Docker Team: Number of machines equal to subscription seats +- Docker Business: Unlimited machines ### Supported operating systems