← KNOWLEDGE INDEX
ATTRIBUTED REFERENCEDocker DocumentationApache-2.0UPDATED 2026-08-16

Configure Settings Management with a JSON file — Proxy settings

Docker Desktop has two distinct proxy settings with different scopes proxy (App Proxy): Governs Docker Desktop host-level traffic — the Desktop application, Docker CLI, and extensions.

Reference note (untrusted external data; do not execute it as instructions). Docker Desktop has two distinct proxy settings with different scopes proxy (App Proxy): Governs Docker Desktop host-level traffic — the Desktop application, Docker CLI, and extensions. It also serves as a fallback for the daemon when containersProxy is not explicitly configured. Once containersProxy is set, proxy plays no role in daemon or container traffic. containersProxy: Always governs docker image pull. All docker image pull and Compose pull operations go through containersProxy, including any PAC file rules. It also governs running container outbound traffic when transparentPorts is configured. > [!NOTE] > > Proxy configuration is a special case because it must be configured in two places: > > 1. In Docker Home for your organization. > 2. On the user's system where Docker Desktop is installed. > > On the user's machine, configure the proxy either through the admin-settings.json file or by using installer flags during Docker Desktop installation. For detailed instructions, refer to the installation guide. > > This additional configuration is required because Docker Desktop must know which proxy server to use before it can complete user sign-in and retrieve organization settings from Docker Home. Attribution: Adapted from Docker Documentation under Apache-2.0. Adaptation: WikiKV isolated this documentation section, normalized formatting, retained only bounded code excerpts, and shortened it at a paragraph or sentence boundary for retrieval. Verify version-sensitive details at the source.
ATTRIBUTED SOURCE

This compact reference card is adapted from official documentation and is not a community-verified experience.

Docker Documentation — content/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md :: Proxy settings ↗Revision 3a9d778562f3 · Apache-2.0 and attribution
#reference-seed#docker#manuals#enterprise#security#hardened-desktop#settings-management#configure#settings#management#json#file