Skip to content
Beginner / 5 min read

How to Set Up a Smartproxy SOCKS5 Proxy on macOS (System-Wide and Per-Browser)

A beginner-friendly macOS guide to configuring a Smartproxy SOCKS5 proxy in Network settings, Chrome, and Firefox, with verification and troubleshooting.

macOS SOCKS5 Privacy/Anonymity

Overview

A SOCKS5 proxy routes application traffic through a remote endpoint and can handle HTTP and HTTPS websites when the app supports SOCKS5. On macOS, you can configure a SOCKS5 proxy system-wide through Network settings or scope it to a specific browser. This tutorial uses Smartproxy as an example provider because it offers residential and datacenter proxies over HTTP and SOCKS5 with flat monthly billing. The same steps apply to any SOCKS5 provider.

You will learn:

  • How to find your Smartproxy SOCKS5 endpoint and credentials.
  • How to set a system-wide SOCKS5 proxy on macOS.
  • How to use SOCKS5 in Chrome and Firefox only.
  • How to verify the proxy is working and fix common errors.

Before You Begin

  • A Smartproxy account with residential or datacenter proxy access.
  • Your SOCKS5 endpoint: host, port, username, and password. Smartproxy usually provides these in the dashboard for the proxy type and location you selected.
  • macOS admin access if you change Network settings.
  • A test URL such as https://httpbin.org/ip or https://ifconfig.me/ip.

Steps

  1. Collect your Smartproxy SOCKS5 credentials.

    Sign in to the Smartproxy dashboard and open the residential or datacenter proxy details. Note the SOCKS5 host, port, username, and password. If the dashboard shows separate HTTP and SOCKS5 ports, use the SOCKS5 port for this tutorial.

  2. Test the SOCKS5 proxy from Terminal before changing macOS settings.

    Replace the placeholders with your details. The socks5h scheme sends DNS requests through the proxy, which reduces DNS leaks.

    curl -x socks5h://USERNAME:PASSWORD@HOST:PORT https://httpbin.org/ip

    If the response shows a different IP address, the proxy credentials and endpoint are working.

  3. Open macOS Network proxy settings.

    • Click the Apple menu and choose System Settings.
    • Select Network.
    • Select your active connection (Wi-Fi or Ethernet) and click Details.
    • Open the Proxies tab.

  4. Enable the SOCKS proxy.

    • Turn on SOCKS Proxy.
    • Enter the Smartproxy SOCKS5 host and port.
    • If macOS shows authentication fields, enter your Smartproxy username and password.
    • Click OK, then click Apply.

  5. Verify system-wide proxying.

    • Open Safari or another app that respects macOS system proxy settings.
    • Visit https://httpbin.org/ip and confirm the IP address differs from your normal public IP.
    • If the page fails, turn the SOCKS proxy off and test the proxy again with the curl command from Step 2.

  6. Scope SOCKS5 to Chrome only (optional).

    Chrome on macOS usually uses system proxy settings, but you can launch a separate Chrome profile with a proxy flag. This is useful when you do not want to change the whole system.

    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' --proxy-server='socks5://HOST:PORT' --user-data-dir=/tmp/chrome-socks5-profile

    Chrome's command-line flag does not handle proxy authentication. If Smartproxy requires a username and password, use system proxy settings, a browser extension from your provider, or a proxy client that supports SOCKS5 authentication. Smartproxy provides browser extensions that can simplify browser-level proxy use; check the provider dashboard for supported browsers and setup notes.

  7. Configure SOCKS5 in Firefox (optional).

    • Open Firefox and go to Settings.
    • Search for Network Settings and click Settings.
    • Select Manual proxy configuration.
    • In the SOCKS Host field, enter the Smartproxy host and port.
    • Select SOCKS v5.
    • Enable Proxy DNS when using SOCKS v5.
    • Click OK.
    • When Firefox asks for proxy authentication, enter your Smartproxy username and password.

  8. Disable the proxy when you are done.

    • Return to System Settings > Network > Details > Proxies.
    • Turn off SOCKS Proxy and click OK.
    • For Chrome, close the proxy profile window and delete /tmp/chrome-socks5-profile if you no longer need it.
    • For Firefox, return to Network Settings and select No proxy.

Troubleshooting

  • Authentication failed: Recheck the username and password. If your password contains special characters, URL-encode it in command-line tools.
  • Proxy works in Terminal but not in apps: Many macOS apps ignore system proxy settings. Use a per-app proxy client or the app's own proxy settings.
  • DNS leaks: Use socks5h in curl and enable Proxy DNS in Firefox. macOS system SOCKS proxy behavior varies by app.
  • Connection times out: Confirm you are using the SOCKS5 port, not the HTTP port. Check that your network allows outbound connections to the proxy port.
  • Websites block the proxy IP: Residential proxies are less likely to be blocked than datacenter IPs, but no proxy guarantees access. Try a different location or proxy type in the Smartproxy dashboard.
  • macOS asks for admin password: System proxy changes require admin rights on most Macs.

Summary

You can use a Smartproxy SOCKS5 proxy on macOS at the system level or only in a browser. Test the endpoint with curl, configure macOS Network settings for system-wide routing, and use browser-specific settings when you need finer control. Always verify your public IP and disable the proxy when the task is complete.