Skip to content

Commit 2712b53

Browse files
authored
Merge pull request #25771 from locker95/docs/windows-registry-certs
docs: note Windows path for registry client certificates
2 parents 4eaf47e + ea0ddf3 commit 2712b53

1 file changed

Lines changed: 18 additions & 2 deletions

File tree

content/manuals/engine/security/certificates.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,26 @@ for the registry and how to set the client TLS certificate for verification.
2121

2222
## Understand the configuration
2323

24-
A custom certificate is configured by creating a directory under
25-
`/etc/docker/certs.d` using the same name as the registry's hostname, such as
24+
A custom certificate is configured by creating a directory under the daemon's
25+
certificate root using the same name as the registry's hostname, such as
2626
`localhost`. All `*.crt` files are added to this directory as CA roots.
2727

28+
Where that certificate root lives depends on the platform:
29+
30+
- Native Linux Engine: `/etc/docker/certs.d/`
31+
- Rootless Linux: `$XDG_CONFIG_HOME/docker/certs.d` (defaults to
32+
`~/.config/docker/certs.d`), not `/etc/docker/certs.d`
33+
- Native Windows Engine (Windows containers):
34+
`%PROGRAMDATA%\docker\certs.d` (normally `C:\ProgramData\docker\certs.d`).
35+
If the registry address includes a port, strip the colon from the directory
36+
name because Windows filenames cannot contain `:`. For example,
37+
`registry.example.com:5000` becomes `registry.example.com5000`.
38+
- Docker Desktop with Linux containers: put client certificates in
39+
`~/.docker/certs.d` on the host. Docker Desktop copies them into the VM;
40+
don't configure `/etc/docker/certs.d` inside the VM yourself. Trusted CAs
41+
can also come from the host certificate store (on Windows, the Windows
42+
certificate store).
43+
2844
> [!NOTE]
2945
>
3046
> On Linux any root certificates authorities are merged with the system defaults,

0 commit comments

Comments
 (0)