> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bentoo.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](http://gate.decodo.com:7000)"**

**https\_proxy="[http://gate.decodo.com:7000](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:password@gate.decodo.com: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.