From 34ceaa8f5b46c237a522ee2ae41c63afff00c9b7 Mon Sep 17 00:00:00 2001 From: Trung Nguyen Date: Thu, 22 Jul 2021 14:34:16 +0200 Subject: [PATCH] Disable hardware acceleration option (#13200) * Disable hardware acceleration option Signed-off-by: Trung Nguyen * Rephrase the suggested update * Update desktop/faqs.md Co-authored-by: Mark H <70579116+mark-dr@users.noreply.github.com> * Indicate disableHardwareAcceleration option in settings.json * Apply suggestions from code review Co-authored-by: Mark H <70579116+mark-dr@users.noreply.github.com> * Minor styling update Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com> Co-authored-by: Mark H <70579116+mark-dr@users.noreply.github.com> --- desktop/faqs.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/desktop/faqs.md b/desktop/faqs.md index 962cf0657c..6a05b1a761 100644 --- a/desktop/faqs.md +++ b/desktop/faqs.md @@ -81,6 +81,19 @@ nested virtualization scenarios**. It might work in some cases, and not in other For more information, see [Running Docker Desktop in nested virtualization scenarios](../docker-for-windows/troubleshoot.md#running-docker-desktop-in-nested-virtualization-scenarios). +### Docker Desktop's UI appears green, distorted, or has visual artifacts. How do I fix this? + +Docker Desktop uses hardware-accelerated graphics by default, which may cause problems for some GPUs. In such cases, +Docker Desktop will launch successfully, but some screens may appear green, distorted, +or have some visual artifacts. + +To work around this issue, disable hardware acceleration by creating a `"disableHardwareAcceleration": true` entry in Docker Desktop's `settings.json` file. You can find this file at: + +- **Mac**: `~/Library/Group Containers/group.com.docker/settings.json` +- **Windows**: `C:\Users\[USERNAME]\AppData\Roaming\Docker\settings.json` + +After updating the `settings.json` file, close and restart Docker Desktop to apply the changes. + ## Releases ### When will Docker Desktop move to a cumulative release stream?