Skip to main content
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 use rotating exit IPs — a new exit IP is assigned per request, so different requests within the same browser session can exit through different IPs. If you need a stable IP across requests and sessions (e.g. for IP allowlists or managed auth health checks), use an ISP proxy instead. See IP rotation behavior across proxy types for the full comparison.

Configuration

Datacenter proxies require a country to route traffic through:
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,
});

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:
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',
  ],
});
Bypass hosts support exact hostnames and wildcard subdomains (*.example.com). See the overview for full details.