Skip to main content

Documentation Index

Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-isp-proxy-static-docs.mintlify.app/llms.txt

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

ISP (Internet Service Provider) proxies are hosted on datacenter infrastructure but use IP addresses assigned by real residential ISPs. Because the ASN belongs to a residential ISP, target sites see them as residential IPs — while the underlying datacenter hosting gives you the speed and stability you’d expect from a datacenter proxy.

IP Rotation Behavior

ISP proxies provide a static exit IP that persists across sessions — every tab, request, reconnection, and future browser session attached to this proxy exits through the same IP. The IP only changes in rare ISP-initiated replacement events (a few times per year on a small number of subnets). This makes ISP proxies suitable for use cases that require a stable IP, such as IP allowlists or managed auth health checks. For comparison with other proxy types, see IP rotation behavior across proxy types.

Configuration

Create an ISP proxy:
import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const proxy = await kernel.proxies.create({
  type: 'isp',
  name: 'my-isp-proxy',
});

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

Configuration Parameters

  • 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: 'isp',
  name: 'isp-with-bypass',
  bypass_hosts: [
    'localhost',
    'internal.service.local',
    '*.amazonaws.com',
  ],
});
See the overview for full bypass host rules and examples.