Skip to content

Commit eb59b5e

Browse files
committed
[windows] update permission requirements
1 parent 62b35be commit eb59b5e

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

content/manuals/desktop/setup/install/windows-permission-requirements.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,23 @@ Docker Desktop on Windows is designed with security in mind. Administrative righ
1818

1919
## Permission requirements
2020

21-
While Docker Desktop on Windows can be run without having `Administrator` privileges, it does require them during installation. On installation you receive a UAC prompt which allows a privileged helper service to be installed. After that, Docker Desktop can be run without administrator privileges, provided you are members of the `docker-users` group. If you performed the installation, you are automatically added to this group, but other users must be added manually. This allows the administrator to control who has access to Docker Desktop.
21+
While Docker Desktop on Windows can be run without having `Administrator` privileges, it does require them during installation. On installation you receive a UAC prompt which allows a privileged helper service to be installed. After that, Docker Desktop can be run without administrator privileges.
2222

23-
The reason for this approach is that Docker Desktop needs to perform a limited set of privileged operations which are conducted by the privileged helper process `com.docker.service`. This approach allows, following the principle of least privilege, `Administrator` access to be used only for the operations for which it is absolutely necessary, while still being able to use Docker Desktop as an unprivileged user.
23+
Running Docker Desktop on Windows without the privilaged helper does not require users to have `docker-users` group membership. However,
24+
some features that require privillaged operations will have this requirement.
25+
26+
If you performed the installation, you are automatically added to this group, but other users must be added manually. This allows the administrator to control who has access to features that require higher privileges, such as creating and managing the Hyper-V VM, or using Windows containers.
27+
28+
When Docker Desktop launches, all non-privileged named pipes will be created so that only the following users can access them:
29+
- The user that launched Docker Desktop.
30+
- Members of the local `Administrators` group.
31+
- The `LOCALSYSTEM` account.
2432

2533
## Privileged helper
2634

35+
The reason for this approach is that Docker Desktop needs to perform a limited set of privileged operations which are conducted by the privileged helper process `com.docker.service`. This approach allows, following the principle of least privilege, `Administrator` access to be used only for the operations for which it is absolutely necessary, while still being able to use Docker Desktop as an unprivileged user.
36+
37+
2738
The privileged helper `com.docker.service` is a Windows service which runs in the background with `SYSTEM` privileges. It listens on the named pipe `//./pipe/dockerBackendV2`. The developer runs the Docker Desktop application, which connects to the named pipe and sends commands to the service. This named pipe is protected, and only users that are part of the `docker-users` group can have access to it.
2839

2940
The service performs the following functionalities:

0 commit comments

Comments
 (0)