docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

ENGDOCS-2256 (#21114) 

* ENGDOCS-2256

* ENGDOCS-2256
This commit is contained in:
Allie Sadler 2024-10-15 15:16:54 +01:00 committed by GitHub
parent a4e17235ab
commit 0da04dd5dd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 45 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
content/manuals/desktop/faqs/general.md
View File

@ -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 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. 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=<userid>` installer flag:
```console
$ /Applications/Docker.app/Contents/MacOS/install --user=<userid>
```
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 >}}

4
content/manuals/desktop/install/mac-install.md
View File

@ -63,6 +63,10 @@ This page contains download URLs, information about system requirements, and ins
## Install and run Docker Desktop on Mac ## 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 ### Install interactively
1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md). 1. Download the installer using the download buttons at the top of the page, or from the [release notes](../release-notes.md).

4
content/manuals/desktop/install/windows-install.md
View File

@ -164,6 +164,10 @@ again when you switch back.
## Install Docker Desktop on Windows ## 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 ### Install interactively
1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md). 1. Download the installer using the download button at the top of the page, or from the [release notes](../release-notes.md).