macOS

​

macOS Proxy Configuration Guide

Set up proxies directly on the macOS operating system for Apple laptops and desktops.

​

Prerequisites

Before proceeding, please ensure that you have:

• No other VPNs or proxies active.
• The proxy endpoint and port (e.g., us.decodo.com:10101).
• Your proxy username and password (or a set of whitelisted IPs).

📘 Proxy Guide Learn how to find the proxy details for each proxy type in the dashboard [here].

​

Proxy Configuration

​

Step 1. First, click the Apple icon located in the top-left corner.

​

Step 2. Then, select System Settings….

​

Step 3. Navigate to the Network section.

​

Step 4. Select Wi-Fi.

​

Step 5. Choose your Wi-Fi connection, then click Details.

​

Step 6. Next, select Proxies in the left-hand panel.

​

Step 7. Select the protocol: HTTP, HTTPS, or SOCKS.

​

Step 8. Fill in the following fields:

• Server (e.g., fr.decodo.com)
• Port (e.g., 40001)

​

Step 9. Set up authentication (optional; you can use whitelisted IPs instead):

1. Toggle the option for Proxy server requires password.
2. Username: Enter your proxy username.
3. Password: Enter your proxy password.

​

Step 10. Click OK.

​

Verify the Connection

1. Open your browser and visit ip.decodo.com.
2. If your IP is not on the whitelist, the system may prompt you to enter credentials. Please input the proxy username and password you specified earlier.

If successful, your IP address will reflect the proxy’s location.

​

Frequently Asked Questions

​

Block List

⚠️ Target Access Notice Please note that we restrict access to certain domain names. You can click [here] to learn more.

​

SOCKS5

🚧 Residential and Mobile Proxy Support SOCKS5 for residential and mobile proxies requires specific configurations to target the correct location and prevent proxy rotation:

​

Country/Region Endpoint Support

Please note that you must use the gate.decodo.com endpoint and port 7000 to utilize SOCKS5 for residential or mobile proxies. Country/region endpoints (e.g., us.decodo.com) will not work! You can specify the location in the username using advanced parameters to target a specific region: Example: user-username-country-us will connect to the US proxy pool.

​

Proxy Rotation

To obtain a sticky SOCKS5 residential or mobile proxy, you must use the session parameter. Otherwise, the proxy will rotate even if the sessionduration parameter is set. Example: user-username-session-abc123-sessionduration-30 will connect to the same session. The session ID name can be defined by any string of your choice. For more details, refer to our Advanced Parameters Guide for Residential and Mobile Proxies.

​

Direct IP

Direct IP Parameter Support If you have purchased an IP list, you can use the direct IP parameter in the proxy username: user-username-ip-x.x.x.x Supported Products: DC Pay/IP, Dedicated DC, ISP Pay/IP, Dedicated ISP plans. Products that provide access to the full proxy pool (e.g., Residential Proxies) do not support this parameter.

​

IP:Port

Decodo proxies do not support the IP:PORT format by default. You must use the endpoint rotator format (e.g., us.decodo.com:10101). If necessary, try the workaround [here], but it will only work temporarily and will require another installation update afterwards.

​

Troubleshooting

If you encounter any other issues, please refer to our main Troubleshooting section.