How to use Microsoft Edge command-line options to configure proxy settings

  • Article

This article describes how you can use command-line options to override the default system network settings.

System network settings

The Microsoft Edge network stack uses the system network settings by default. These settings include proxy settings, and certificate and private key stores.

There are scenarios where users request an alternative to using the system's default proxy settings. To support these scenarios, Microsoft Edge supports command-line options that you can use to configure custom proxy settings.

These command-line options correspond to the following policies in the Proxy server group:

Command-line options for proxy settings

Microsoft Edge supports the following proxy-related command-line options.

--no-proxy-server

Tells Microsoft Edge not to use a Proxy, even if the system is otherwise configured to use one. It overrides any other proxy settings that are provided.

--proxy-auto-detect

Tells Microsoft Edge to try and automatically detect your proxy configuration. This argument is ignored if --proxy-server is configured.

--proxy-server=<scheme>=<uri>[:<port>][;...] | <uri>[:<port>] | "direct://"

Tells Microsoft Edge to use a custom proxy configuration. You can specify a custom proxy configuration in three ways.

  1. Provide a semicolon-separated mapping of list scheme to url/port pairs. For example, --proxy-server="http=proxy1:8080;ftp=ftpproxy" tells Microsoft Edge to use HTTP proxy "proxy1:8080" for http URLs and HTTP proxy "ftpproxy:80" for ftp URLs.
  2. By providing a single uri with optional port to use for all URLs. For example, --proxy-server="proxy2:8080" will use the proxy at "proxy2:8080" for all traffic.
  3. By using the special "direct://" value. For example, --proxy-server="direct://" will make all connections not use a proxy.

Note

You can configure Microsoft Edge to try using a proxy and fallback to going direct if the proxy isn't available. For example, --proxy-server="http://proxy2:8080,direct://.

--proxy-bypass-list=(<trailing_domain>|<ip-address>)[:<port>][;...]

Tells Microsoft Edge to bypass any specified proxy for the specified semicolon-separated list of hosts. This flag must be used with --proxy-server.

Note

Trailing-domain matching doesn't require "." separators, "*microsoft.com" will match "imicrosoft.com". For example, --proxy-server="proxy2:8080" --proxy-bypass-list="*.microsoft.com;*example.com;127.0.0.1:8080" will use the proxy server "proxy2" on port 8080 for all hosts except requests for *.microsoft.com, example.com, and 127.0.0.1 on port 8080. In the previous example, imicrosoft.com requests will still be proxied. However, iexample.com requests will bypass the proxy because *example.com was specified instead of *.example.com.

--proxy-pac-url=<pac-file-url>

Tells Microsoft Edge to use the PAC file at the specified URL. For example, --proxy-pac-url="https://wpad/proxy.pac" tells Microsoft Edge to resolve proxy information for URL requests using the proxy.pac file.

Content license

Note

Portions of this page are modifications based on work created and shared by Chromium.org and used according to terms described in the Creative Commons Attribution 4.0 International License. The original page can be found here.

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.

See also