Thanks to visit codestin.com
Credit goes to docs.brightdata.com

Skip to main content

​
Your proxy access information

Bright Data proxies are grouped in “Proxy zones”. Each zone holds the configuration for the proxies it holds.To get access to the proxy zone:
  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the Overview tab.
  4. In the overview tab, under Access details you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool’s proxy configuration.

​
Access Details Section Example

​
Residential proxy access

To access Bright Data’s Residential Proxies you will need to either get verified by our compliance team, or install a certificate. Read more…

​
Targeting search engines?

If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (SERP) proxy API. Use Bright Data SERP API to target search engines. Click here to read more about Bright Data SERP proxy API.

​
Correct setup of proxy test to avoid “PROXY ERROR”

In many tools you will see a “test proxy” function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy. To correctly test your proxy you should target those search queries to: https://geo.brdtest.com/welcome.txt .Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show proxy error although your proxy is perfectly fine.If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
Maintain a consistent IP throughout your browsing session by using the -session parameter in your username. Bright Data proxies rotate IPs by default.
Learn moreNew users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in Immediate-Access mode.For account management use cases, assign a consistent static dedicated IP per account. Dedicated ISP proxies are recommended.

​
Why Use Bright Data on macOS?

Adding Bright Data proxies to your macOS network settings enables you to:
  • Enhance Privacy: Hide your real IP address and browse securely
  • Access Geo-Restricted Content: Route traffic through different countries and regions
  • Maintain Stable Connections: Reduce detection risks across browsers and desktop applications
  • System-Wide Coverage: Apply proxy routing to all apps that respect macOS network settings

​
Setting Up Bright Data on macOS

1

Prerequisites

Before you begin, ensure you have:
  • Bright Data Proxy Credentials
    Log in to your Bright Data dashboard to retrieve:
    • Host
    • Port
    • Username
    • Password
      Also confirm whether you are using HTTP, HTTPS, or SOCKS5 proxies.
  • A macOS device running macOS 10.12 (Sierra) or later
2

Open Network Settings

  1. Click the Apple menu in the top-left corner of your screen.
  2. Select System Settings (or System Preferences on older macOS versions).
  1. Open Network and select the connection you want to configure (for example, Wi-Fi or Ethernet).
3

Open Advanced Network Options

  1. Click Details… (or Advanced… on older versions).
  1. Navigate to the Proxies tab.
4

Select the Proxy Type

Choose the proxy protocol based on your Bright Data setup:
  • Web Proxy (HTTP) for HTTP proxies
  • Secure Web Proxy (HTTPS) for HTTPS proxies
  • SOCKS Proxy for SOCKS5 proxies
5

Enter Bright Data Proxy Details

Fill in the proxy configuration fields:
  • Server: brd.superproxy.io
  • Port: Use the port provided in your Bright Data dashboard
  • Enable Proxy server requires password
  • Username: Your Bright Data username
    (Optionally append -session-<id> for IP persistence or -country-XX for geo-targeting)
  • Password: Your Bright Data proxy password
Click OK, then Apply to save the configuration.
6

Verify the Proxy Connection

  1. Open Safari, Chrome, or another browser.
  2. Visit:
http://httpbin.org/ip
  1. Confirm the displayed IP matches your Bright Data proxy IP.

​
Best Practices

  • Use ISP or Datacenter proxies for long-running desktop workflows
  • Avoid frequently switching networks when using proxies
  • Keep credentials secure and rotate sessions periodically
  • Recheck proxy settings after macOS updates
  • Use one proxy per account for account-based tasks

​
Conclusion

You’ve successfully configured Bright Data on macOS. Your system traffic is now routed through secure, anonymous proxy connections, enabling private browsing and geo-flexible access across applications. With Bright Data in place, your Mac is ready for safer, more reliable online operations.