Skip to content

Commit 5852a53

Browse files
committed
daemon: Document Unix socket setup on Windows
Show the Engine 29.5 opt-in listener and matching client endpoint. Explain group access and why the socket should use a user-profile path. Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
1 parent 1fe539c commit 5852a53

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

content/manuals/engine/daemon/_index.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,32 @@ $ dockerd --debug \
8484
--host tcp://192.168.59.3:2376
8585
```
8686

87+
#### Listen on a Unix socket on Windows
88+
89+
Starting with Docker Engine 29.5, you can configure `dockerd` on Windows to
90+
listen on a Unix socket. This setting is optional. The default Windows endpoint
91+
remains the `npipe` named pipe.
92+
93+
Run `dockerd` from an elevated PowerShell session:
94+
95+
```powershell
96+
PS C:\> dockerd -H unix://C:/Users/<USER>/docker.sock --group docker-users
97+
```
98+
99+
Replace `<USER>` with your Windows user directory. Without `--group`, only
100+
members of the Administrators group and the `SYSTEM` account can access the
101+
socket. Use a comma-separated list to grant access to multiple users or groups.
102+
103+
Use a path in the user profile when granting access with `--group`. A socket
104+
created directly under `C:\` can inherit a high integrity level that blocks
105+
access for the configured users and groups.
106+
107+
Configure the Docker client to use the same socket:
108+
109+
```powershell
110+
PS C:\> docker -H unix://C:/Users/<USER>/docker.sock info
111+
```
112+
87113
Learn about the available configuration options in the
88114
[dockerd reference docs](/reference/cli/dockerd.md), or by
89115
running:

0 commit comments

Comments
 (0)