Skip to content

Commit e3c779b

Browse files
aevesdockerelegantcoder
authored andcommitted
Engdocs 2076 (docker#19910)
* ENGDOCS-2076 * ENGDOCS-2076
1 parent 766c311 commit e3c779b

File tree

4 files changed

+41
-12
lines changed

4 files changed

+41
-12
lines changed

content/desktop/networking.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -53,21 +53,24 @@ See:
5353
- [Proxies on Mac](settings/mac.md#proxies)
5454
- [Proxies on Windows](settings/windows.md#proxies)
5555

56-
### SOCKS5 proxy support (Beta)
56+
### SOCKS5 proxy support
5757

58-
SOCKS (Socket Secure) is a protocol that facilitates the routing of network packets between a client and a server through a proxy server. It provides a way to enhance privacy, security, and network performance for users and applications.
58+
{{< introduced desktop 4.28.0 "release-notes.md#4280" >}}
5959

60-
With Docker Desktop 4.28 and later, you can enable SOCKS proxy support to allow outgoing requests, such as pulling images, and access Linux container backend IPs from the host.
60+
> **Note**
61+
>
62+
> Requires a Business subscription.
6163
62-
To enable and set up SOCKS proxy support:
64+
SOCKS (Socket Secure) is a protocol that facilitates the routing of network packets between a client and a server through a proxy server. It provides a way to enhance privacy, security, and network performance for users and applications.
65+
66+
You can enable SOCKS proxy support to allow outgoing requests, such as pulling images, and access Linux container backend IPs from the host.
6367

64-
1. Navigate to **Settings** in Docker Desktop.
65-
2. Go to **Features in development** and then on the **Beta** tab check the **Enable SOCKS proxy support** option.
66-
3. Select **Apply & restart**.
67-
4. Go to the **Resources** tab and from the dropdown menu select **Proxies**
68-
5. Switch on the **Manual proxy configuration** toggle.
69-
6. In the **Secure Web Server HTTPS** box, paste your `socks5://host:port` URL.
68+
To enable and set up SOCKS proxy support:
7069

70+
1. Navigate to the **Resources** tab in **Settings**.
71+
2. From the dropdown menu select **Proxies**.
72+
3. Switch on the **Manual proxy configuration** toggle.
73+
4. In the **Secure Web Server HTTPS** box, paste your `socks5://host:port` URL.
7174

7275
{{< /tab >}}
7376
{{< tab name="For Mac and Linux" >}}

content/desktop/settings/linux.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -135,17 +135,35 @@ File share settings are:
135135

136136
### Proxies
137137

138-
To configure HTTP proxies, switch on the **Manual proxy configuration** setting.
139-
This setting is used for logging into Docker, for pulling and pushing images, and for
138+
HTTP/HTTPS proxies can be used when:
139+
140+
- Signing in to Docker
141+
- Pulling or pushing images
142+
- Fetching artifacts during image builds
143+
- Containers interact with the external network
144+
- Scanning images
145+
146+
If the host uses a HTTP/HTTPS proxy configuration (static or via Proxy Auto-Configuration), Docker Desktop reads
147+
this configuration
148+
and automatically uses these settings for signing in to Docker, for pulling and pushing images, and for
140149
container Internet access. If the proxy requires authorization then Docker Desktop dynamically asks
141150
the developer for a username and password. All passwords are stored securely in the OS credential store.
142151
Note that only the `Basic` proxy authentication method is supported so we recommend using an `https://`
143152
URL for your HTTP/HTTPS proxies to protect passwords while in transit on the network. Docker Desktop
144153
supports TLS 1.3 when communicating with proxies.
145154

155+
To set a different proxy for Docker Desktop, turn on **Manual proxy configuration** and enter a single
156+
upstream proxy URL of the form `http://proxy:port` or `https://proxy:port`.
157+
146158
To prevent developers from accidentally changing the proxy settings, see
147159
[Settings Management](../hardened-desktop/settings-management/index.md#what-features-can-i-configure-with-settings-management).
148160

161+
The HTTPS proxy settings used for scanning images are set using the `HTTPS_PROXY` environment variable.
162+
163+
> **Note**
164+
>
165+
> Docker Desktop also supports the use of [SOCKS5 proxies](../networking.md#socks5-proxy-support).
166+
149167
### Network
150168

151169
{{< include "desktop-network-setting.md" >}}

content/desktop/settings/mac.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,10 @@ To prevent developers from accidentally changing the proxy settings, see
199199

200200
The HTTPS proxy settings used for scanning images are set using the `HTTPS_PROXY` environment variable.
201201

202+
> **Note**
203+
>
204+
> Docker Desktop also supports the use of [SOCKS5 proxies](../networking.md#socks5-proxy-support).
205+
202206
### Network
203207

204208
{{< include "desktop-network-setting.md" >}}

content/desktop/settings/windows.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -216,6 +216,10 @@ The HTTPS proxy settings used for scanning images are set using the `HTTPS_PROXY
216216
If you are running Windows containers in Docker, you can allow the Windows Docker daemon to use Docker Desktop's internal proxy, with the **Use proxy for Windows Docker daemon** setting.
217217
This is useful when a corporate proxy that requires authentication is manually configured or set at the system level. If you are an admin for your organization and have a Docker Business subscription, you can control this setting with [Settings management](../hardened-desktop/settings-management/configure.md) using the `windowsDockerdPort` parameter.
218218

219+
> **Note**
220+
>
221+
> Docker Desktop also supports the use of [SOCKS5 proxies](../networking.md#socks5-proxy-support).
222+
219223
### Network
220224

221225
> **Note**

0 commit comments

Comments
 (0)