Mac proxy settings are in System Settings > Network > (your connection, such as Wi-Fi) > Details > Proxies. Safari, Chrome and many Mac apps use what you set there. Two things trip people up: the setting belongs to one connection (Wi-Fi and Ethernet are separate), and Terminal tools ignore it entirely. This guide covers both, step by step.
New to proxies? See what a proxy server is first.
What you need before you start
- Proxy address (host name or IP) and port.
- Protocol — HTTP or SOCKS5. macOS supports both. See HTTP vs SOCKS5 if you are unsure.
- Login — a username and password, or an IP allow-list where your provider accepts your own public address (see public vs private IP address).
Setting a proxy in System Settings
macOS Ventura and later
- Open the Apple menu > System Settings.
- Click Network in the sidebar.
- Click the connection you use — usually Wi-Fi — then click Details next to the network name.
- Choose Proxies in the left column.
- Turn on the proxy type you need (next section), and enter the server and port.
- Click OK.
macOS Monterey and earlier
- Open System Preferences > Network.
- Select your connection on the left, then click Advanced.
- Open the Proxies tab, tick the proxy type, enter server and port.
- Click OK, then Apply.
Which proxy types to turn on
The Proxies list has several options. For a typical provider’s proxy, you only need these:
| Option in the list | What it covers | When to turn it on |
|---|---|---|
| Web proxy (HTTP) | Plain http:// pages |
For an HTTP proxy — turn on together with the next one |
| Secure web proxy (HTTPS) | https:// pages |
For an HTTP proxy — enter the same server and port |
| SOCKS proxy | All supported traffic via SOCKS | For a SOCKS5 proxy — on its own, instead of the two above |
| Automatic proxy configuration | A setup script (PAC file) address | Only if you were given a script address |
A common mistake is turning on only “Web proxy (HTTP)”. Almost every site today uses HTTPS, so nothing seems to change. Turn on both the Web and Secure web proxy, with the same details. “Secure web proxy” does not mean the proxy itself needs to be special — it just means “use this proxy for HTTPS sites”.
Username and password
Unlike Windows, macOS lets you store a login with the proxy. Under each proxy type, turn on Proxy server requires password and enter the username and password. macOS keeps them in your keychain.
Some apps still ask for the password the first time, or do not support proxy passwords at all. If an app keeps failing with 407 Proxy Authentication Required, either set the proxy inside that app, or use your provider’s IP allow-list so no password is needed.
Excluding addresses from the proxy
At the bottom of the Proxies panel there is a box for hosts and domains that should go directly, without the proxy. Separate entries with commas:
*.local, 169.254/16, 192.168.0.0/16, intranet.example.com
Keep the local network entries macOS adds by default, and add any company or partner systems that must see your own connection.
Wi-Fi, Ethernet and other connections
On a Mac, proxy settings belong to a network connection, not to the whole computer. If you set a proxy on Wi-Fi and then plug in an Ethernet cable or connect through a USB adapter, the Mac may switch to that connection — which has no proxy. Set the proxy on each connection you use, or check which one is active before you start work.
Which apps follow the Mac setting
| App or tool | Uses the Mac proxy setting? |
|---|---|
| Safari, Chrome, Edge | Yes |
| Firefox | Only if set to “Use system proxy settings” |
| Many Mac apps | Often — check the app’s own network settings |
curl, Python, Node.js, Git, Homebrew |
No — they read environment variables |
Terminal: networksetup and environment variables
Set the system proxy from Terminal
Handy if you switch often. First list your connection names:
networksetup -listallnetworkservices
Then set the HTTP and HTTPS proxy on Wi-Fi (replace host and port):
networksetup -setwebproxy "Wi-Fi" proxy-host port
networksetup -setsecurewebproxy "Wi-Fi" proxy-host port
Check the current setting, and turn it off again:
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -setwebproxystate "Wi-Fi" off
networksetup -setsecurewebproxystate "Wi-Fi" off
For SOCKS5, the equivalent commands are -setsocksfirewallproxy and -setsocksfirewallproxystate.
Make Terminal tools use the proxy
For the current Terminal window only:
export http_proxy="http://user:pass@proxy-host:port"
export https_proxy="http://user:pass@proxy-host:port"
To make it permanent, add those two lines to the file ~/.zshrc (the default shell settings file on modern macOS), then open a new Terminal window. Remember the password is then stored in plain text in that file; remove the lines when you no longer need them. To stop for the current window: unset http_proxy https_proxy.
Checking that it works
- In Safari or Chrome, open
https://api.ipify.org. You should see the proxy’s address. - In Terminal, after the
exportlines above:curl https://api.ipify.orgIt should show the same address.
- Open a page you care about and check that currency and language match the proxy location. Match your Mac’s language and time zone too, or you may get a mixed result.
For a fuller check, see how to test proxy quality.
Troubleshooting
- Nothing changed — you probably turned on only “Web proxy (HTTP)”. Turn on “Secure web proxy (HTTPS)” too.
- Works on Wi-Fi, not at the office desk — the Mac switched to Ethernet, which has its own (empty) proxy setting.
- 407 Proxy Authentication Required — check “Proxy server requires password” and the login, or your allow-listed address.
- Browser uses the proxy, Terminal does not — set
http_proxyandhttps_proxy. - SOCKS details entered as Web proxy — the protocols do not match. Use the SOCKS proxy option for SOCKS5 details.
- Some sites fail, others work — check the exceptions box, and whether a VPN app or a company profile is also changing network settings.
Using YiluProxy on a Mac
All five YiluProxy lines give you the host, port and login used above, over HTTP or SOCKS5: rotating residential, static residential, rotating datacenter, static datacenter and mobile. For a proxy in Chrome only, without changing the whole Mac, see how to set up a proxy in Chrome. On Windows instead? See Windows proxy settings.
A proxy changes where requests come from; it does not change any website’s rules. Use it on publicly visible pages and your own accounts and assets.
FAQ
Q1. Where are proxy settings on a Mac?
A. System Settings > Network > your connection > Details > Proxies. On older macOS: System Preferences > Network > Advanced > Proxies.
Q2. Should I use Web proxy or Secure web proxy?
A. For an HTTP proxy, turn on both with the same server and port. Secure web proxy is what HTTPS sites — almost all of them — use.
Q3. Can macOS save my proxy password?
A. Yes. Turn on “Proxy server requires password” under the proxy type and enter the login; it is stored in your keychain.
Q4. Why does Terminal ignore my Mac proxy settings?
A. Command-line tools read environment variables, not System Settings. Set http_proxy and https_proxy as shown above.
Test first, then buy
Set up a trial proxy on your Mac with the steps above and check it against your own target pages.
(Menu names are based on current macOS versions and may differ slightly after updates. Written October 2026.)