> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-mason-add-copy-page-to-context-menu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Residential Proxies

Residential proxies route traffic through real residential IP addresses. They support advanced targeting options including city, state, and operating system.

## Configuration

Residential proxies support multiple targeting parameters:

<CodeGroup>
  ```typescript Typescript/Javascript theme={null}
  import { Kernel } from '@onkernel/sdk';
  const kernel = new Kernel();

  const proxy = await kernel.proxies.create({
    type: 'residential',
    name: 'my-la-residential',
    config: {
      country: 'US',
      city: 'los_angeles'
    }
  });

  const browser = await kernel.browsers.create({
    proxy_id: proxy.id
  });
  ```

  ```Python Python theme={null}
  import kernel
  client = kernel.Kernel()

  proxy = client.proxies.create(
      type='residential',
      name='my-la-residential',
      config={
          'country': 'US',
          'city': 'los_angeles'
      }
  )

  browser = client.browsers.create(
      proxy_id=proxy.id
  )
  ```
</CodeGroup>

## Configuration Parameters

* **`country`** - ISO 3166 country code. Must be provided when providing other targeting options.
* **`state`** - Two-letter state code. Only supported for US.
* **`city`** - City name (lowercase, no spaces, e.g., `sanfrancisco`, `newyork`).
* **`zip`** - US ZIP code (5 digits). Conflicts with city and state.
* **`asn`** - Autonomous System Number. Conflicts with city and state.