@@ -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