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

# Operating System

> Residential Proxy Operating System Specification

<Warning>
  The operating system specification feature can be enabled with an active Residential plan. To request access to this feature, contact us at [support@decodo.com](mailto:support@decodo.com). Note that you may have to complete a KYC form.
</Warning>

To specify the operating system with the residential proxy, you have to include the `os` variable in the proxy **username**. The operating system name is specified after the variable, like so:  `os-windows`.

## Supported Operating Systems

The following operating systems are possible to target with residential proxies:

* `macos`
* `windows`
* `linux`
* `ios`
* `android`

## <br />**Examples**

### **Username:password**

Adding the `os-xxxx` to your username will allow for operating system targeting.

An example of a **rotating proxy** that returns IPs from macOS devices:

```shellscript cURL theme={null}
curl -U "user-username-os-macos:password" -x "gate.decodo.com:10000" "https://ip.decodo.com/json"
```

**Rotating** IPs from Android devices:

```shellscript cURL theme={null}
curl -U "user-username-os-android:password" -x "gate.decodo.com:10000" "https://ip.decodo.com/json"
```

### **Whitelisted IP**

Adding the `os-xxxx` to your proxy will allow for operating system targeting.

An example of a **rotating proxy** that returns IPs from windows devices:

```shellscript cURL theme={null}
curl -x "https://os-windows.gate.decodo.com:10000" "https://ip.decodo.com/json"
```

<Note>
  ### Note

  The IP pool may be narrower with the `os` variable.
</Note>

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>