Skip to content

Commit 0da04dd

Browse files
authored
ENGDOCS-2256 (#21114)
* ENGDOCS-2256 * ENGDOCS-2256
1 parent a4e1723 commit 0da04dd

File tree

3 files changed

+45
-0
lines changed

3 files changed

+45
-0
lines changed

content/manuals/desktop/faqs/general.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,3 +65,40 @@ For more information and examples, see [how to connect from a container to a ser
6565

6666
It is not possible to pass through a USB device (or a
6767
serial port) to a container as it requires support at the hypervisor level.
68+
69+
### How do I run Docker Desktop without administrator privileges?
70+
71+
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.
72+
73+
{{< tabs >}}
74+
{{< tab name="Mac" >}}
75+
76+
To run Docker Desktop on Mac without requiring administrator privileges, install via the command line and pass the `—user=<userid>` installer flag:
77+
78+
```console
79+
$ /Applications/Docker.app/Contents/MacOS/install --user=<userid>
80+
```
81+
82+
You can then sign in to your machine with the user ID specified, and launch Docker Desktop.
83+
84+
> [!NOTE]
85+
>
86+
> 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.
87+
88+
{{< /tab >}}
89+
{{< tab name="Windows" >}}
90+
91+
> [!NOTE]
92+
>
93+
> 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.
94+
95+
To run Docker Desktop on Windows without requiring administrator privileges, install via the command line and pass the `—always-run-service` installer flag.
96+
97+
```console
98+
$ "Docker Desktop Installer.exe" install —always-run-service
99+
```
100+
101+
{{< /tab >}}
102+
{{< /tabs >}}
103+
104+

content/manuals/desktop/install/mac-install.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,10 @@ This page contains download URLs, information about system requirements, and ins
6363

6464
## Install and run Docker Desktop on Mac
6565

66+
> [!TIP]
67+
>
68+
> 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.
69+
6670
### Install interactively
6771

6872
1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md).

content/manuals/desktop/install/windows-install.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -164,6 +164,10 @@ again when you switch back.
164164

165165
## Install Docker Desktop on Windows
166166

167+
> [!TIP]
168+
>
169+
> 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.
170+
167171
### Install interactively
168172

169173
1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md).

0 commit comments

Comments
 (0)