Datacenter Proxies

Datacenter proxies use IP addresses assigned from datacenter servers to route your traffic and access locations around the world. With a shorter journey and simplified architecture, datacenter proxies are both the fastest and most cost-effective proxy option.

IP Rotation Behavior

Datacenter proxies provide a stable exit IP within a single browser session — every tab, request, and reconnection inside that session exits through the same IP, and it does not rotate mid-session (unlike residential).

For cross-session IP stability (e.g. IP allowlists or managed auth health checks), see IP rotation behavior across proxy types.

Configuration

Datacenter proxies require a country to route traffic through:

Typescript/Javascript

import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const proxy = await kernel.proxies.create({
  type: 'datacenter',
  name: 'my-us-datacenter',
  config: {
    country: 'US',
  },
});

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

from kernel import Kernel

kernel = Kernel()

proxy = kernel.proxies.create(
    type="datacenter",
    name="my-us-datacenter",
    config={
        "country": "US",
    }
)

browser = kernel.browsers.create(proxy_id=proxy.id)

Configuration Parameters

• country (optional) - ISO 3166 country code (e.g., US, GB, FR) or EU for European Union exit nodes
• bypass_hosts (optional) - Array of hostnames that bypass the proxy and connect directly (max 100 entries)

Bypass hosts

Configure specific hostnames to bypass the proxy:

Typescript/Javascript

import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const proxy = await kernel.proxies.create({
  type: 'datacenter',
  name: 'datacenter-with-bypass',
  config: {
    country: 'US',
  },
  bypass_hosts: [
    'localhost',
    'internal.service.local',
    '*.amazonaws.com',
  ],
});

from kernel import Kernel

kernel = Kernel()

proxy = kernel.proxies.create(
    type="datacenter",
    name="datacenter-with-bypass",
    config={
        "country": "US",
    },
    bypass_hosts=[
        "localhost",
        "internal.service.local",
        "*.amazonaws.com",
    ]
)

Bypass hosts support exact hostnames and wildcard subdomains (*.example.com). See the overview for full details.