Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tbd-6fc993ce-pools-fill-rate-1772767851.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.

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.