From 2bc74c70288a829e13360110e56b18fd49978090 Mon Sep 17 00:00:00 2001 From: masnwilliams <43387599+masnwilliams@users.noreply.github.com> Date: Wed, 27 May 2026 23:50:59 +0000 Subject: [PATCH 1/2] docs: correct stealth default proxy from residential to ISP Co-Authored-By: Claude Opus 4.7 --- browsers/bot-detection/stealth.mdx | 2 +- changelog.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/browsers/bot-detection/stealth.mdx b/browsers/bot-detection/stealth.mdx index d0b0fb3..09162e6 100644 --- a/browsers/bot-detection/stealth.mdx +++ b/browsers/bot-detection/stealth.mdx @@ -43,7 +43,7 @@ kernel_browser = kernel.browsers.create( Anti-detection is the platform default, so you can freely mix in your own networking or CAPTCHA tooling. Common patterns: -- **BYO proxy, keep CAPTCHA solver** — launch a stealth browser with your own [proxy](/proxies/overview) via `proxy_id`. Replaces the residential default; CAPTCHA solver stays loaded. +- **BYO proxy, keep CAPTCHA solver** — launch a stealth browser with your own [proxy](/proxies/overview) via `proxy_id`. Replaces the ISP default; CAPTCHA solver stays loaded. - **BYO proxy, no CAPTCHA solver** — launch a non-stealth browser with your own `proxy_id`. Full anti-detection config, no managed proxy or CAPTCHA extension. - **Disable the default proxy at runtime** — on a running stealth browser, set [`disable_default_proxy`](/proxies/overview#disable-default-proxy-on-stealth-browsers) to route directly while keeping the CAPTCHA solver. diff --git a/changelog.mdx b/changelog.mdx index bc12827..4b7c0ef 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -68,7 +68,7 @@ For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-n - Launched [Projects](/info/projects) so you can keep `production` and `staging` separate, split resources between teams, scope API keys to a single environment, and cap concurrency per project so one workload can't exhaust your org quota. Existing resources have been moved into a **Default** project, so nothing changes for current workloads. - Kernel is now a [Cloudflare Web Bot Auth partner](https://www.kernel.sh/blog/cloudflare). Kernel browsers can [cryptographically identify themselves](/browsers/bot-detection/web-bot-auth) to Cloudflare-protected sites, so Kernel traffic isn't blocked. -- Anti-detection features are now on by default for all Kernel browsers. [Stealth mode](/browsers/bot-detection/stealth) now specifically adds the managed residential proxy and CAPTCHA solver (both opt-out), and non-stealth browsers fully support [custom proxies](/proxies/custom). +- Anti-detection features are now on by default for all Kernel browsers. [Stealth mode](/browsers/bot-detection/stealth) now specifically adds the managed ISP proxy and CAPTCHA solver (both opt-out), and non-stealth browsers fully support [custom proxies](/proxies/custom). - Revamped the [managed auth hosted login page](/auth/hosted-ui): all available sign-in options (password fields, SSO providers, MFA, alternate sign-in methods) now render together on a single page, so end users can pick the path they want, instead of being funneled through one at a time. - Managed auth input fields now display contextual helper text when the site surfaces hints, reducing user confusion on multi-step logins. - The "Save credentials after login" option is now automatically disabled when [1Password](/integrations/1password) is selected as the [credential source](/auth/credentials), since those credentials are already managed externally. From 52e75408ca589bf85c9758ec6135de9ef1c991a2 Mon Sep 17 00:00:00 2001 From: masnwilliams <43387599+masnwilliams@users.noreply.github.com> Date: Wed, 27 May 2026 23:59:04 +0000 Subject: [PATCH 2/2] docs: add stealth + BYO proxy code example Co-Authored-By: Claude Opus 4.7 --- browsers/bot-detection/stealth.mdx | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/browsers/bot-detection/stealth.mdx b/browsers/bot-detection/stealth.mdx index 09162e6..0f17aa6 100644 --- a/browsers/bot-detection/stealth.mdx +++ b/browsers/bot-detection/stealth.mdx @@ -47,6 +47,26 @@ Anti-detection is the platform default, so you can freely mix in your own networ - **BYO proxy, no CAPTCHA solver** — launch a non-stealth browser with your own `proxy_id`. Full anti-detection config, no managed proxy or CAPTCHA extension. - **Disable the default proxy at runtime** — on a running stealth browser, set [`disable_default_proxy`](/proxies/overview#disable-default-proxy-on-stealth-browsers) to route directly while keeping the CAPTCHA solver. +### Stealth with your own proxy + +To run a stealth browser through your own proxy instead of the managed ISP default, pass both `stealth: true` and a `proxy_id` when creating the session. The CAPTCHA solver stays loaded; your proxy replaces the ISP default. + + +```typescript Typescript/Javascript +const kernelBrowser = await kernel.browsers.create({ + stealth: true, + proxy_id: myProxy.id, +}); +``` + +```python Python +kernel_browser = kernel.browsers.create( + stealth=True, + proxy_id=my_proxy.id, +) +``` + + If you're looking for proxy-level configuration with Kernel browsers, see [Proxies](/proxies/overview). ## CAPTCHA Handling Behavior