We use cookies to enhance user experience, personalize content, and analyze traffic. Cookie Policy

← Back to all articles

Mac Proxy Settings: How to Set Proxies on macOS

Configure Mac proxy settings for HTTP, HTTPS, SOCKS, or PAC files, then verify browser traffic and fix authentication or connection problems.

by Unknown Proxies

11 min read

July 26, 2026

Mac Proxy Settings: How to Set Proxies on macOS

Mac proxy settings are under Apple menu > System Settings > Network > your active network service > Details > Proxies. Choose the proxy type your provider or network administrator specified, enter the server and port, add credentials if required, then save and verify your public IP in a browser.

The setting belongs to a network service such as Wi-Fi or Ethernet. Safari and Chrome normally use the macOS system proxy, while Firefox can use either the system configuration or its own connection settings. Some apps and non-web traffic may ignore the system web proxy, so test every app that matters instead of assuming the whole Mac is covered.

This guide covers manual HTTP and HTTPS proxies, SOCKS proxies, PAC files, authentication, bypass rules, testing, and safe removal.

Mac Proxy Settings: Quick Setup

For a manual web proxy:

  1. Copy the proxy protocol, hostname, port, username, and password from your provider or administrator.
  2. Open Apple menu > System Settings > Network.
  3. Select the active service, such as Wi-Fi or Ethernet, then click Details.
  4. Select Proxies.
  5. Turn on Web proxy (HTTP), Secure web proxy (HTTPS), or both, exactly as your provider instructs.
  6. Enter the server address and port in their separate fields.
  7. If needed, turn on Proxy server requires password and enter the proxy username and password.
  8. Click OK, then verify the public IP and load a normal HTTPS page.

Apple's current Mac proxy settings reference documents the same path and the available HTTP, HTTPS, SOCKS, automatic configuration, discovery, and bypass options.

Information you have Where it goes
proxy.example.com Proxy server field
8080 Port field
username User name field after enabling password authentication
password Password field
http://proxy.example.com:8080 Split into server proxy.example.com and port 8080
PAC URL Automatic proxy configuration URL field

Do not guess the protocol from the port alone. An HTTP proxy and a SOCKS5 proxy can use the same port number but expect different connection handshakes. If the protocol is unclear, check the provider dashboard or compare the practical differences in SOCKS5 vs HTTP proxy.

Diagram of Mac proxy settings routing Safari and Chrome through a selected network service while Firefox and other apps may use separate rules

What the macOS Proxy Options Mean

macOS exposes several proxy controls in one panel. Enable only the option that matches the endpoint or configuration your provider supplied.

macOS option Use it when Information required
Web proxy (HTTP) The provider gives you an HTTP proxy for HTTP destinations Server, port, and optional credentials
Secure web proxy (HTTPS) The provider tells you to proxy HTTPS destinations through that endpoint Server, port, and optional credentials
SOCKS proxy The endpoint is explicitly SOCKS4 or SOCKS5 Server, port, and optional credentials
Automatic proxy configuration An administrator gives you a PAC file URL PAC URL
Auto proxy discovery An organization tells the Mac to discover proxy rules automatically A compatible managed network

A commercial HTTP proxy provider often gives one host and port to enter under both Web proxy (HTTP) and Secure web proxy (HTTPS). Do that only when the provider says the endpoint supports both. Do not enable SOCKS for an HTTP endpoint or copy a SOCKS5 endpoint into the web-proxy fields.

For Chrome, the Secure web proxy (HTTPS) field selects the route for HTTPS destinations. It does not enable TLS on the connection to the proxy itself. If the provider supplies an https:// proxy endpoint, use a supported PAC file or Chrome-specific proxy configuration, as described in Chromium's HTTPS proxy documentation.

The word HTTPS in a destination URL does not mean you should paste https:// before the proxy hostname. Keep the server and port separate. Normal HTTPS pages remain protected by TLS between the browser and destination when an HTTP proxy relays the connection with a tunnel. The HTTP connection to the proxy still exposes the CONNECT destination and any Basic proxy-authentication credentials. Use that route only over a trusted network, or use a provider-supported TLS connection to the proxy. An unexpected certificate warning after setup can indicate interception or a broken network path; do not install an unfamiliar root certificate merely to dismiss it.

Before You Change the Proxy

Collect these values first:

Record your direct public IP before enabling the proxy. You can compare it with the result afterward using an IP-check endpoint such as https://ipv4.unknownproxies.com/ip.

Start with one proxy and one browser. Changing the endpoint, protocol, network service, browser extension, and DNS settings at the same time makes a simple formatting error much harder to find.

How to Configure an HTTP or HTTPS Proxy on Mac

Open the proxy panel:

  1. Choose Apple menu > System Settings.
  2. Click Network in the sidebar.
  3. Click the active connection, then Details.
  4. Select Proxies in the details window.

For a provider entry such as:

proxy.example.com:8080
username: sample-user
password: sample-password
protocol: HTTP

turn on the web-proxy options the provider supports, enter proxy.example.com as the server and 8080 as the port, then enable Proxy server requires password and put the credentials in their separate fields.

Chrome does not use credentials saved in the platform's manual proxy fields. It uses its own authentication flow when the proxy requests credentials, so a browser prompt can still appear. See Chromium's manual proxy credential notes.

Click OK to save. Open a new browser tab for the first test. If a browser was already displaying a proxy authentication prompt, close the prompt or restart that browser before deciding the new values did not work.

Do not paste a full username:password@host:port string into the server field. That format is useful in cURL and some scripts, but the macOS panel already provides separate server, port, username, and password controls. If your proxy list needs to be rearranged first, use the proxy converter.

How to Configure a SOCKS Proxy on Mac

Use SOCKS proxy only when the provider explicitly identifies the endpoint as SOCKS.

  1. Return to System Settings > Network > active service > Details > Proxies.
  2. Turn on SOCKS proxy.
  3. Enter the SOCKS server and port.
  4. If the endpoint uses username and password authentication, enable the password option and enter them.
  5. Turn off unrelated HTTP or HTTPS proxy toggles unless your network administrator told you to combine them.
  6. Click OK and test the applications that should use the route.

macOS provides the system SOCKS field, but app behavior still matters. A browser may honor the system route while another app uses its own network stack or proxy setting. DNS behavior can also vary by client. If remote name resolution is a requirement, test it with the actual app rather than treating a changed public IP as proof that every DNS lookup follows the proxy.

Chrome does not support SOCKS5 username/password authentication, even when macOS stores those credentials. For Chrome, use an endpoint that allows your source IP, a local client that handles upstream authentication, or a provider-supported HTTP proxy. The Chromium proxy reference documents this limit.

How to Use a PAC File or Auto Discovery

A proxy auto-configuration file contains rules that decide whether each URL should use a proxy or connect directly. Use it when an employer, school, or network administrator gives you a PAC URL.

To add one:

  1. Open the macOS Proxies panel.
  2. Turn on Automatic proxy configuration.
  3. Enter the complete PAC URL supplied by the administrator.
  4. Click OK.
  5. Test both a destination that should use the proxy and one that should bypass it.

Do not substitute Auto proxy discovery merely because a PAC URL fails. Discovery depends on network configuration and should be enabled only when the network administrator expects it. A stale, unreachable, or malformed PAC file can prevent routes from resolving correctly, so record the URL and test it directly when troubleshooting.

Do Safari, Chrome, and Firefox Use Mac Proxy Settings?

Safari follows the macOS network proxy configuration. Chrome also uses system network settings by default; Chromium's network settings documentation explains that the browser network stack reads the operating system proxy configuration.

Firefox can behave differently because it has its own connection setting. In Firefox, open Settings, find Network Settings, then choose Use system proxy settings if you want it to follow macOS. Mozilla's Firefox connection settings guide also documents manual proxy and automatic configuration choices.

If one browser ignores the expected route, check for:

System proxy settings do not guarantee that every Mac app, background service, game, or non-HTTP connection uses the proxy. Configure app-level proxy support or a routing method designed for broader traffic when that is the real requirement.

How to Verify Mac Proxy Settings

Test in layers:

  1. With the proxy off, record the public IP shown by an IP-check page.
  2. Enable the proxy and reload the IP page in a new tab.
  3. Confirm the result matches the expected proxy exit rather than the original connection.
  4. Load a separate HTTPS website.
  5. Test each browser or app you expect to use.
  6. Repeat the check after switching from Wi-Fi to Ethernet, if both connections matter.
  7. For a sticky or static proxy, confirm the exit stays consistent across the intended session.

A changed IP proves that the tested request used a different route. It does not prove that every app, DNS query, local service, or protocol on the Mac is proxied.

For permitted regional QA, compare both the IP and the actual page behavior. A website can also use account state, cookies, browser language, and other signals, so changing the route alone does not guarantee a particular localized response.

Visual checklist for verifying a Mac proxy with baseline IP, proxy route, HTTPS test, app coverage, and rollback

Troubleshooting Mac Proxy Settings

Use the symptom to decide what to inspect.

Symptom Likely cause First check
No pages load Wrong host, port, protocol, or unavailable proxy Turn off the proxy, confirm direct access, then retest one endpoint
Public IP does not change Wrong network service, bypass rule, or app ignores the system proxy Confirm the active Wi-Fi or Ethernet service and test Safari
Username prompt keeps returning Wrong credentials, unsupported auth method, or inactive plan Recopy the username and password and check provider status
HTTP works but HTTPS fails Secure web proxy is missing or the endpoint does not support the configured route Check the HTTPS toggle and provider protocol
Safari works but Firefox does not Firefox is using its own proxy choice Select Use system proxy settings in Firefox
Browser works but another app does not The app bypasses the system proxy or uses non-web traffic Check that app's proxy support
It works on Wi-Fi but not Ethernet Proxy was configured only for the Wi-Fi service Configure the intended network service separately
Local or internal sites fail Bypass list is incomplete Add only administrator-approved local hosts or domains

Fix Repeated Authentication Prompts

A repeated prompt means the browser can often reach the proxy but authentication is not being accepted. Recheck the complete username, including any country, region, or session suffix. Confirm the password has not expired and the endpoint supports username/password authentication.

An HTTP 407 Proxy Authentication Required response points to the proxy layer, not the destination website. Use the 407 proxy authentication guide to separate credential, protocol, format, and account-status failures.

Check the Active Network Service

The proxy configuration is attached to the network service you edited. If the Mac moves from Wi-Fi to Ethernet, a dock, or another adapter, the new active service may have different proxy settings.

Return to Network, identify the connection marked active, and inspect its Proxies panel. Avoid duplicating settings across every service unless each one genuinely needs the same route.

Remove Conflicting Extensions or App Settings

Temporarily disable one proxy or VPN extension at a time and retest. Also check whether the failing browser has its own manual configuration. Do not run multiple routing tools and assume their order is predictable.

If the route works in Safari but not Chrome, test a clean Chrome profile before changing the macOS configuration. If it works in both but not Firefox, switch Firefox to the system proxy or deliberately configure Firefox separately.

Use Bypass Rules Carefully

Exclude simple hostnames can keep names such as an internal server host off the proxy. The separate bypass list can exclude explicit hosts and domains. Add only what should connect directly, such as administrator-approved internal services.

A broad bypass rule can silently send more traffic directly than intended. After changing the list, retest both a bypassed internal host and an external IP-check page.

How to Turn Off a Proxy on Mac

Return to System Settings > Network > active service > Details > Proxies. Turn off the specific options you enabled, including Web proxy (HTTP), Secure web proxy (HTTPS), SOCKS proxy, Automatic proxy configuration, or Auto proxy discovery, then click OK.

Test direct browsing again. If the Mac still uses a proxy, inspect browser extensions, Firefox connection settings, VPN or routing clients, enterprise policies, and the proxy settings on the currently active network service.

Do not reset all network settings as a first step. Removing the exact proxy option preserves unrelated Wi-Fi, DNS, VPN, and adapter configuration.

Choosing a Proxy for Mac Browser Work

Choose the proxy around the session rather than the operating system:

Proxies do not override website permissions or usage policies. For scraping or automation, respect robots directives where applicable, terms, access controls, rate limits, and relevant law. Use app-level Playwright, Puppeteer, Selenium, or HTTP-client proxy settings when automation needs isolated sessions rather than changing the whole Mac network service.

FAQ

Where are proxy settings on a Mac?

Open Apple menu > System Settings > Network, select the active network service, click Details, then select Proxies.

Does Chrome use Mac proxy settings?

Chrome uses the macOS system proxy settings by default. A Chrome extension, command-line flag, or enterprise policy can override the effective configuration.

Does Safari use Mac proxy settings?

Yes. Safari uses the macOS network proxy configuration. Test Safari first when you want to confirm the system web proxy is active.

Are Mac proxy settings system-wide?

They are system network settings for the selected network service, but not every application or protocol must honor them. Firefox can use its own configuration, and some apps or non-web traffic may bypass a web proxy.

Can I use a SOCKS5 proxy on macOS?

macOS provides a SOCKS proxy option. Enter the server and port, then verify each app and any DNS behavior that matters to your workflow. Authentication support depends on the app; Chrome does not support SOCKS5 username/password authentication.

Why do Mac proxy settings work on Wi-Fi but not Ethernet?

Wi-Fi and Ethernet are separate network services. Configure and test the proxy on the service that is actually carrying the Mac's traffic.

How do I remove proxy settings from a Mac?

Open the active network service's Proxies panel, turn off every proxy option you enabled, and click OK. Then check browser-specific settings or extensions if traffic still appears proxied.

Final Thoughts on Mac Proxy Settings

Reliable Mac proxy settings start with the correct protocol and the correct active network service. Enter the host, port, and credentials in separate fields, enable only the required HTTP, HTTPS, SOCKS, or PAC option, and verify one browser before expanding the test.

Treat a changed browser IP as evidence for that request—not proof that the entire Mac is covered. Test each relevant app, keep bypass rules narrow, and turn off the exact proxy option when the route is no longer needed.

About the Author

Unknown Proxies

Proxy Infrastructure Team

Stay Unknown

High-performance dedicated proxies optimized for speed and reliability. Get uncompromising quality, 99.9% uptime, and unmatched support. Stay Unknown.

Explore Plans