Skip to content

Commit 04d0957

Browse files
Improve security documentation with warning around windows containers (#21929)
## Description Some background dialog between security, desktop, moby teams and some security researchers. At the present time, this is an accepted risk in Docker Desktop installations for Windows and should be clarified in better detail. ## Related issues or tickets PSEC-1839 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review @gabriellavengeo - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Allie Sadler <[email protected]>
1 parent 1fe65be commit 04d0957

File tree

2 files changed

+6
-2
lines changed

2 files changed

+6
-2
lines changed

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

+1-1
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@ By default, Docker Desktop is installed at `C:\Program Files\Docker\Docker`.
210210
The `install` command accepts the following flags:
211211
- `--quiet`: Suppresses information output when running the installer
212212
- `--accept-license`: Accepts the [Docker Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement) now, rather than requiring it to be accepted when the application is first run
213-
- `--no-windows-containers`: Disables the Windows containers integration
213+
- `--no-windows-containers`: Disables the Windows containers integration. This can improve security. For more information, see [Windows containers](/manuals/desktop/setup/install/windows-permission-requirements.md#windows-containers).
214214
- `--allowed-org=<org name>`: Requires the user to sign in and be part of the specified Docker Hub organization when running the application
215215
- `--backend=<backend name>`: Selects the default backend to use for Docker Desktop, `hyper-v`, `windows` or `wsl-2` (default)
216216
- `--installation-dir=<path>`: Changes the default installation location (`C:\Program Files\Docker\Docker`)

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

+5-1
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,11 @@ isolated from the Docker daemon and other services running inside the VM.
6767

6868
## Windows Containers
6969

70-
Unlike the Linux Docker engine and containers which run in a VM, Windows containers are an operating system feature, and run directly on the Windows host with `Administrator` privileges. For organizations who don't want their developers to run Windows containers, a `–no-windows-containers` installer flag is available from version 4.11 to disable their use.
70+
> [!WARNING]
71+
>
72+
> Enabling Windows containers has important security implications.
73+
74+
Unlike the Linux Docker Engine and containers which run in a VM, Windows containers are implemented using operating system features, and run directly on the Windows host. If you enable Windows containers during installation, the `ContainerAdministrator` user used for administration inside the container is a local administrator on the host machine. Enabling Windows containers during installation makes it so that members of the `docker-users` group are able to elevate to administrators on the host. For organizations who don't want their developers to run Windows containers, a `-–no-windows-containers` installer flag is available to disable their use.
7175

7276
## Networking
7377

0 commit comments

Comments
 (0)