Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-intro-create-control-observe.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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