diff --git a/content/manuals/desktop/faqs/general.md b/content/manuals/desktop/faqs/general.md index c228c6a342f9..6fbdaa921f4f 100644 --- a/content/manuals/desktop/faqs/general.md +++ b/content/manuals/desktop/faqs/general.md @@ -65,3 +65,40 @@ For more information and examples, see [how to connect from a container to a ser It is not possible to pass through a USB device (or a serial port) to a container as it requires support at the hypervisor level. + +### How do I run Docker Desktop without administrator privileges? + +Docker Desktop requires administrator privileges only for installation. Once installed, administrator privileges are not needed to run it. However, for non-admin users to run Docker Desktop, it must be installed using a specific installer flag and meet certain prerequisites, which vary by platform. + +{{< tabs >}} +{{< tab name="Mac" >}} + +To run Docker Desktop on Mac without requiring administrator privileges, install via the command line and pass the `—user=` installer flag: + +```console +$ /Applications/Docker.app/Contents/MacOS/install --user= +``` + +You can then sign in to your machine with the user ID specified, and launch Docker Desktop. + +> [!NOTE] +> +> Before launching Docker Desktop, if a `settings.json` file already exists in the `~/Library/Group Containers/group.com.docker/` directory, you will see a **Finish setting up Docker Desktop** window that prompts for administrator privileges when you select **Finish**. To avoid this, ensure you delete the `settings.json` file left behind from any previous installations before launching the application. + +{{< /tab >}} +{{< tab name="Windows" >}} + +> [!NOTE] +> +> If you are using the WSL 2 backend, first make sure that you meet the [minimum required version](/manuals/desktop/wsl/best-practices.md) for WSL 2. Otherwise, update WSL 2 first. + +To run Docker Desktop on Windows without requiring administrator privileges, install via the command line and pass the `—always-run-service` installer flag. + +```console +$ "Docker Desktop Installer.exe" install —always-run-service +``` + +{{< /tab >}} +{{< /tabs >}} + + diff --git a/content/manuals/desktop/install/mac-install.md b/content/manuals/desktop/install/mac-install.md index d6d743afbc88..47379f9f4383 100644 --- a/content/manuals/desktop/install/mac-install.md +++ b/content/manuals/desktop/install/mac-install.md @@ -63,6 +63,10 @@ This page contains download URLs, information about system requirements, and ins ## Install and run Docker Desktop on Mac +> [!TIP] +> +> See the [FAQs](/manuals/desktop/faqs/general.md#how-do-I-run-docker-desktop-without-administrator-privileges) on how to install and run Docker Desktop without needing administrator privileges. + ### Install interactively 1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md). diff --git a/content/manuals/desktop/install/windows-install.md b/content/manuals/desktop/install/windows-install.md index 1537e2c845b4..d1e8beff42a4 100644 --- a/content/manuals/desktop/install/windows-install.md +++ b/content/manuals/desktop/install/windows-install.md @@ -164,6 +164,10 @@ again when you switch back. ## Install Docker Desktop on Windows +> [!TIP] +> +> See the [FAQs](/manuals/desktop/faqs/general.md#how-do-I-run-docker-desktop-without-administrator-privileges) on how to install and run Docker Desktop without needing administrator privileges. + ### Install interactively 1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md).