From 68ef4b352b4447251cddc98686f4ccd9513e4c8a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:11:27 +0000 Subject: [PATCH 1/7] Update proxies/overview.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/overview.mdx | 62 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 61 insertions(+), 1 deletion(-) diff --git a/proxies/overview.mdx b/proxies/overview.mdx index 986e0a31..60700d49 100644 --- a/proxies/overview.mdx +++ b/proxies/overview.mdx @@ -105,7 +105,67 @@ browser = kernel.browsers.create(proxy_id=proxy.id) ``` -## 4. Delete a proxy +## 4. Bypass hosts + +Configure specific hostnames to bypass the proxy and connect directly. This is useful for accessing internal services, metadata endpoints, or reducing latency for trusted domains. + + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const kernel = new Kernel(); + +const proxy = await kernel.proxies.create({ + type: 'datacenter', + name: 'proxy-with-bypass', + config: { + country: 'US', + }, + bypass_hosts: [ + 'localhost', + 'internal.company.local', + 'metadata.google.internal', + '*.amazonaws.com', + ], +}); +``` + +```python Python +from kernel import Kernel + +kernel = Kernel() + +proxy = kernel.proxies.create( + type="datacenter", + name="proxy-with-bypass", + config={ + "country": "US", + }, + bypass_hosts=[ + "localhost", + "internal.company.local", + "metadata.google.internal", + "*.amazonaws.com", + ] +) +``` + + +### Bypass host rules + +- **Exact hostnames**: `example.com`, `api.service.local` +- **Wildcard subdomains**: `*.example.com` matches `api.example.com`, `cdn.example.com`, etc. +- **Maximum 100 entries** per proxy +- **Maximum 253 characters** per hostname +- Hostnames are case-insensitive and automatically normalized +- Ports, paths, and URL schemes are not allowed +- IP addresses are not supported—use hostnames only + + +Bypass hosts is available on Start-Up and Enterprise plans. + + +## 5. Delete a proxy When no longer needed, delete the proxy configuration: From 9d25f132159f8baa1644f366e2c8295ed1874553 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:11:39 +0000 Subject: [PATCH 2/7] Update reference/cli/browsers.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- reference/cli/browsers.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/reference/cli/browsers.mdx b/reference/cli/browsers.mdx index 63e73458..7d501e6f 100644 --- a/reference/cli/browsers.mdx +++ b/reference/cli/browsers.mdx @@ -402,6 +402,7 @@ Create a new proxy configuration. | `--port ` | Proxy port (custom; required). | | `--username ` | Proxy username (custom). | | `--password ` | Proxy password (custom). | +| `--bypass-host ` | Hostname to bypass proxy (repeatable; max 100). | | `--output json`, `-o json` | Output raw JSON object. | ### `kernel proxies delete ` From 242fd44e71840bf59a268af12fb1c1f6283af31a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:11:49 +0000 Subject: [PATCH 3/7] Update proxies/datacenter.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/datacenter.mdx | 47 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/proxies/datacenter.mdx b/proxies/datacenter.mdx index 01518bbf..f1d759a4 100644 --- a/proxies/datacenter.mdx +++ b/proxies/datacenter.mdx @@ -47,3 +47,50 @@ 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 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', + ], +}); +``` + +```python Python +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](/proxies/overview#bypass-hosts) for full details. From e3862face2fd724d6c0738f9c1f0c864913f900b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:12:00 +0000 Subject: [PATCH 4/7] Update proxies/residential.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/residential.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/proxies/residential.mdx b/proxies/residential.mdx index 36c01ed8..1772cc49 100644 --- a/proxies/residential.mdx +++ b/proxies/residential.mdx @@ -51,6 +51,7 @@ browser = kernel.browsers.create(proxy_id=proxy.id) - **`city`** - City name (lowercase, no spaces, e.g., `sanfrancisco`, `newyork`). - **`zip`** - US ZIP code (5 digits). Conflicts with city and state. - **`asn`** - Autonomous System Number. Conflicts with city and state. +- **`bypass_hosts`** (optional) - Array of hostnames that bypass the proxy and connect directly (max 100 entries) ## Advanced Targeting Examples From 72e36ee1ef36190deaf66d8781db83729d80063f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:12:07 +0000 Subject: [PATCH 5/7] Update proxies/residential.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/residential.mdx | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/proxies/residential.mdx b/proxies/residential.mdx index 1772cc49..f72f623a 100644 --- a/proxies/residential.mdx +++ b/proxies/residential.mdx @@ -160,3 +160,41 @@ proxy = kernel.proxies.create( If the ASN is not matched, the API will return the most-available 10 examples. + +## Bypass hosts + +Configure specific hostnames to bypass the proxy and connect directly: + + +```typescript Typescript/Javascript +const proxy = await kernel.proxies.create({ + type: 'residential', + name: 'residential-with-bypass', + config: { + country: 'US', + }, + bypass_hosts: [ + 'localhost', + 'metadata.google.internal', + '*.internal.company.com', + ], +}); +``` + +```python Python +proxy = kernel.proxies.create( + type='residential', + name='residential-with-bypass', + config={ + 'country': 'US', + }, + bypass_hosts=[ + 'localhost', + 'metadata.google.internal', + '*.internal.company.com', + ] +) +``` + + +See the [overview](/proxies/overview#bypass-hosts) for full bypass host rules and examples. From 777ffb370026c81994f110deb5c657762108eab2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:12:18 +0000 Subject: [PATCH 6/7] Update proxies/custom.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/custom.mdx | 55 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/proxies/custom.mdx b/proxies/custom.mdx index f1ab29a3..029bdfcf 100644 --- a/proxies/custom.mdx +++ b/proxies/custom.mdx @@ -62,7 +62,62 @@ browser = kernel.browsers.create(proxy_id=proxy.id) - **`port`** (required) - Proxy server port (1-65535) - **`username`** - Username for proxy authentication - **`password`** - Password for proxy authentication (minimum 5 characters) +- **`bypass_hosts`** (optional) - Array of hostnames that bypass the proxy and connect directly (max 100 entries) When creating a proxy with authentication, provide the password. The API response will only indicate if a password exists (`has_password: true`) but won't return the actual password for security reasons. + +## Bypass hosts + +Configure specific hostnames to bypass your custom proxy: + + +```typescript Typescript/Javascript +import Kernel from '@onkernel/sdk'; + +const kernel = new Kernel(); + +const proxy = await kernel.proxies.create({ + type: 'custom', + name: 'custom-with-bypass', + protocol: 'https', + config: { + host: 'proxy.example.com', + port: 443, + username: 'user123', + password: 'secure_password', + }, + bypass_hosts: [ + 'localhost', + 'internal.service.local', + '*.trusted-domain.com', + ], +}); +``` + +```python Python +from kernel import Kernel + +kernel = Kernel() + +proxy = kernel.proxies.create( + type="custom", + name="custom-with-bypass", + protocol="https", + config={ + "host": "proxy.example.com", + "port": 443, + "username": "user123", + "password": "secure_password", + }, + bypass_hosts=[ + "localhost", + "internal.service.local", + "*.trusted-domain.com", + ] +) +``` + + +This is useful for accessing internal services or metadata endpoints without routing through your proxy. See the [overview](/proxies/overview#bypass-hosts) for full bypass host rules. From 110eda8fa7e309265827faac1971c7ef368d4361 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:12:30 +0000 Subject: [PATCH 7/7] Update proxies/isp.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- proxies/isp.mdx | 46 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) diff --git a/proxies/isp.mdx b/proxies/isp.mdx index 63dc861d..25f0ce9c 100644 --- a/proxies/isp.mdx +++ b/proxies/isp.mdx @@ -36,4 +36,48 @@ proxy = kernel.proxies.create( browser = kernel.browsers.create(proxy_id=proxy.id) ``` - \ No newline at end of file + + +## 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: + + +```typescript Typescript/Javascript +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', + ], +}); +``` + +```python Python +from kernel import Kernel + +kernel = Kernel() + +proxy = kernel.proxies.create( + type="isp", + name="isp-with-bypass", + bypass_hosts=[ + "localhost", + "internal.service.local", + "*.amazonaws.com", + ] +) +``` + + +See the [overview](/proxies/overview#bypass-hosts) for full bypass host rules and examples. \ No newline at end of file