Linux

​

Linux Proxy Configuration Guide

Linux offers a variety of distributions for those interested in alternative operating systems. Unfortunately, it is not feasible to cover the configuration methods for all distributions. This guide is designed to help you clearly understand the setup of a system-level proxy.

​

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, open the terminal.

​

Step 2. Then, log in as the root user.

​

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

​

Step 4. You should now see a text editor window. Configure your proxy as follows:

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 can also be configured via http://username:[email protected]:7000.

​

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

​

Step 6. Finally, lock the file and restart your machine. Note that if this step is skipped, the proxy changes may be lost.

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

​

Verify the Connection

Open your browser and visit ip.decodo.com. 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.