> ## 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.

# 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.