From 3da683f2476f304f23dba4f2ea1b44065231e46b Mon Sep 17 00:00:00 2001 From: Dave123981 Date: Sun, 4 Oct 2026 09:39:24 +0100 Subject: [PATCH] docs: fix Container proxy table to show nested properties correctly - Restructure Container proxy documentation to clarify that pac and embeddedPac are nested properties within containersProxy object - Add separate table documenting all containersProxy nested properties (locked, mode, http, https, exclude, pac, embeddedPac, transparentPorts) - Include JSON configuration example showing correct structure - Align with settings-reference.md documentation Fixes #26263 - Administrators can now clearly see the correct JSON structure to avoid configuration errors --- .../configure-json-file.md | 30 +++++++++++++++++-- 1 file changed, 28 insertions(+), 2 deletions(-) diff --git a/content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md b/content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md index ffa2600251b..cf5c0814b89 100644 --- a/content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md +++ b/content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md @@ -339,8 +339,34 @@ Docker Desktop has two distinct proxy settings with different scopes: | 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](../air-gapped-containers.md). | | -| `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. | | + +The `containersProxy` setting accepts the following nested properties: + +| Property | Description | +| :---------------- | :-----------| +| `locked` | When set to `true`, users cannot modify this setting. | +| `mode` | Proxy mode: `manual` or `system`. | +| `http` | HTTP proxy URL. For example, `"http": "http://proxy.example.com:8080"`. | +| `https` | HTTPS proxy URL. For example, `"https": "https://proxy.example.com:8443"`. | +| `exclude` | List of addresses to bypass the proxy. For example, `"exclude": ["localhost", "127.0.0.1"]`. | +| `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. | +| `transparentPorts` | Specifies which ports should use transparent proxy. | + +Example configuration: + +```json +"containersProxy": { + "locked": true, + "mode": "manual", + "http": "", + "https": "", + "exclude": [], + "pac": "", + "embeddedPac": "", + "transparentPorts": "" +} +``` ### Linux VM settings