Skip to content

daemon: Document Unix socket setup on Windows #25660

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vvoland wants to merge 1 commit into
base: main
Choose a base branch
from
Open

daemon: Document Unix socket setup on Windows #25660

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions content/manuals/engine/daemon/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,33 @@ $ dockerd --debug \
--host tcp://192.168.59.3:2376
```

#### Listen on a Unix socket on Windows

@docker-agent docker-agent Jul 28, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[MEDIUM] New section uses #### heading which is excluded from the table of contents

The document's toc_max defaults to 3 (h3), as no override is set in the front matter. The #### Listen on a Unix socket on Windows heading introduced by this PR is at level h4, so it won't appear in the rendered table of contents.

Consider using ### instead to give this section ToC visibility, or add toc_max: 4 to the front matter if nesting under ### Configuration using flags is intentional.


Starting with Docker Engine 29.5, you can configure `dockerd` on Windows to
listen on a Unix socket. This setting is optional. The default Windows endpoint
remains the `npipe` named pipe.

Run `dockerd` from an elevated PowerShell session:

```powershell
PS C:\> dockerd -H unix://C:/Users/<USER>/docker.sock --group docker-users
```

Replace `<USER>` with the name of your Windows user profile directory.
Without `--group`, only members of the Administrators group and the `SYSTEM`
account can access the socket. Use a comma-separated list to grant access to
multiple users or groups.

Use a path in the user profile when granting access with `--group`. A socket
created directly under `C:\` can inherit a high integrity level that blocks
access for the configured users and groups.

Configure the Docker client to use the same socket:

```powershell
PS C:\> docker -H unix://C:/Users/<USER>/docker.sock info
```

Learn about the available configuration options in the
[dockerd reference docs](/reference/cli/dockerd.md), or by
running:
Expand Down