Linux

Linux offers a variety of distributions for those interested in an alternative OS. Unfortunately, covering the setup on all of them would be unfeasible. This guide aims to provide a clear understanding of a system-wide proxy setup.

Getting Started

Before proceeding, ensure you have:

No other VPN or proxy active.
The proxy endpoint and port (e.g., us.decodo.com:10101).
Your proxy username and password (or a whitelisted IP set).

📘
Proxy Guides

Learn how to find proxy details in your dashboard for each proxy type here.

Proxy Setup

Step 1. First, open Terminal.

Step 2. Then, sign in as a root user.

Step 3. Next, open /etc/environment file with nano.

Step 4. You should now be presented with a text editor window. Configure your proxy:

http_proxy="http://gate.decodo.com:7000"
https_proxy="http://gate.decodo.com:7000"
no_proxy="localhost"

You can select any other endpoint from the available list. If needed, username:password authentication is also available via http://username:[email protected]:7000.

Step 5. To finish editing the selected file, hit CTRL + X, then enter Y to save changes, and confirm the file location by pressing ENTER.

Step 6. Finally, lock the file and reboot your machine. Please note that proxy changes may disappear if you skip this step.

To lock the file, enter chattr +i /etc/environment. To unlock it later, you can use the -i flag.

Verify the Connection

Open a browser and visit ip.decodo.com. If successful, your IP address will reflect the location of the proxy.

Common Issues

Blocklist

⚠️
Target Access

Please be aware that we restrict access to some domains. You can learn more here.

`SOCKS5`

🚧
Residential and Mobile Proxy Support

SOCKS5 for residential and mobile proxies requires specific settings to target the correct locations and prevent proxy rotation:

Country Endpoint Support

Please note that you must use the gate.decodo.com endpoint and the 7000 port to utilize SOCKS5 Residential or Mobile proxies. Country endpoints, such as us.decodo.com, will not function!

You can target specific locations instead by specifying the location in your username using advanced parameters:

e.g.: user-username-country-us will connect to the USA pool.

Proxy Rotation

To get a sticky SOCKS5 Residential or Mobile proxy in a tool, you must use a session parameter. Otherwise, the proxy will always rotate even with a set sessionduration parameter.

e.g.: 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.

Learn more in our advanced parameter guides for Residential and Mobile proxies.

Direct IP

Direct IP Parameter Support

If you buy an IP list, you can specify which IPs to connect to using 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 offer access to the full proxy pool, such as residential proxies, do not support this parameter.

IP:PORT

Decodo proxies don't support an 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 only works temporarily before requiring another setup update.

Troubleshooting

If you experience any other issues, please refer to our main troubleshooting section.

Support

Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.