You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[docs-scanner] Container proxy table misleadingly presents nested properties as separate parameters #26263
The "Container proxy" section table presents pac and embeddedPac as if they are separate top-level parameters, when they are actually nested properties within the containersProxy object.
From the table:
Parameter
OS
Description
Version
containersProxy
Configures the proxy for docker image pull (always enforced) and running container outbound traffic (enforced when transparentPorts is set). For more information see Air-Gapped Containers.
pac
Specifies a PAC file URL. For example, "pac": "http://containerproxy/proxy.pac".
embeddedPac
Specifies an embedded PAC (Proxy Auto-config) script. For example, "embeddedPac": "function FindProxyForURL(url, host) { return \"PROXY 192.168.92.1:2003\"; }". This setting takes precedence over HTTP, HTTPS, Proxy bypass and PAC server URL.
However, the example JSON in the same file shows the correct structure:
And settings-reference.md correctly documents this as a single JSON object with nested properties.
Why this matters
Administrators reading the table might incorrectly create their JSON configuration with pac and embeddedPac as separate top-level keys instead of nested within containersProxy. This would result in invalid configuration that Docker Desktop would ignore or reject.
Suggested fix
Restructure the table to show the nested relationship, similar to how other nested settings are documented in the same file (e.g., enhancedContainerIsolation.dockerSocketMount.imageList). Alternatively, present containersProxy as a single entry with a JSON example showing all its properties, matching the approach used in settings-reference.md.
Activity