The Ultimate Guide to macOS Proxy Settings (System-Wide)

This guide provides clear, step-by-step instructions with the latest screenshots for configuring a system-wide proxy on macOS. Whether you're using manual HTTP/SOCKS proxies or an automatic configuration (PAC), we've got you covered.

Understanding System-Wide vs. Browser-Specific Proxies

A system-wide proxy configured in macOS Network settings affects most applications (e.g., Safari, Chrome, and many desktop apps). Some applications may use their own proxy configuration and not follow system settings (e.g., certain developer tools). If your proxy works in Safari/Chrome but not in Firefox or a specific app, configure that app’s network settings separately.

Method 1: Manual Proxy Setup (HTTP/HTTPS/SOCKS)

  1. Open System Settings (on macOS Ventura and later) or System Preferences (on macOS Monterey and earlier).
  2. Navigate to Network, select your active connection (e.g., Wi‑Fi or Ethernet), then click Details… or Advanced….
  3. Open the Proxies tab.
  4. Enable the appropriate proxy types:
    • Web Proxy (HTTP): Enter server and port.
    • Secure Web Proxy (HTTPS): Enter server and port.
    • SOCKS Proxy: Enter server and port (for SOCKS5 flows).
  5. If your service requires authentication, check Proxy server requires password and enter credentials.
  6. Click OK then Apply to save.
  7. Verify your connection via What's My IP.

Note: If you enable multiple proxies, ensure each has the correct server and port. For HTTPS, certificates and MITM tools may affect behavior.

Method 2: Automatic Proxy Setup (Using a PAC file)

What is a PAC file?

A Proxy Auto-Config (PAC) file is a JavaScript-based configuration that defines smart routing rules—deciding which traffic should go through the proxy and which should connect directly. It is ideal for complex environments or selective proxying.

How to Apply a PAC File in macOS

  1. Open System Settings → Network (or System Preferences → Network).
  2. Select your active connection and open Proxies.
  3. Enable Automatic Proxy Configuration.
  4. Enter the URL of your PAC file (Script address) provided by your service.
  5. Click OK and Apply, then verify with What's My IP.

❗ Troubleshooting Common macOS Proxy Issues

Issue 1: "I can't browse after enabling the proxy."

  • Double-check server and port values.
  • Try another proxy endpoint; current one may be down.
  • Check local firewall or security software that may block connections.

Issue 2: "Proxy works in Safari/Chrome but not in app X."

Some apps do not follow the system proxy and require their own configuration. Check the app’s network settings or consult its documentation.

Issue 3: "How do I turn off the proxy?"

  1. Open System Settings → Network (or System Preferences → Network).
  2. Open Proxies and disable the previously enabled proxy types (HTTP/HTTPS/SOCKS or Automatic Proxy Configuration).
  3. Click OK and Apply.
Verify IP & Location ← Back to Setup Guides