From de0116a66f5d6119356081135910ff0958ae8fc6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 14:41:38 +0000 Subject: [PATCH 1/8] Update browsers/create-a-browser.mdx --- browsers/create-a-browser.mdx | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/browsers/create-a-browser.mdx b/browsers/create-a-browser.mdx index 7b3aeba..5afa5c5 100644 --- a/browsers/create-a-browser.mdx +++ b/browsers/create-a-browser.mdx @@ -148,4 +148,16 @@ async with async_playwright() as playwright: ## Connection notes - **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. - Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. -- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. \ No newline at end of file +- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. + +## Troubleshooting + +### Browser spin-up time + +Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready. + +**Standard configuration** includes: +- Headful and headless browsers +- Stealth mode both enabled and disabled + +If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. \ No newline at end of file From 8e19300d116620178c81a378bf295da1cda15e15 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 14:45:41 +0000 Subject: [PATCH 2/8] Update browsers/create-a-browser.mdx --- browsers/create-a-browser.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/browsers/create-a-browser.mdx b/browsers/create-a-browser.mdx index 5afa5c5..6a78299 100644 --- a/browsers/create-a-browser.mdx +++ b/browsers/create-a-browser.mdx @@ -145,11 +145,6 @@ async with async_playwright() as playwright: -## Connection notes -- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. -- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. -- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. - ## Troubleshooting ### Browser spin-up time @@ -160,4 +155,9 @@ Non-standard configuration can affect browser spin-up time. Settings like non-de - Headful and headless browsers - Stealth mode both enabled and disabled -If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. \ No newline at end of file +If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. + +### Connection notes +- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. +- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. +- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. \ No newline at end of file From b2279967a5ee9ecb8bfa8beb014c906fa5667491 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 15:57:42 +0000 Subject: [PATCH 3/8] Update browsers/faq.mdx --- browsers/faq.mdx | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 browsers/faq.mdx diff --git a/browsers/faq.mdx b/browsers/faq.mdx new file mode 100644 index 0000000..40ac6f3 --- /dev/null +++ b/browsers/faq.mdx @@ -0,0 +1,20 @@ +--- +title: "FAQ" +description: "Frequently asked questions about Kernel browsers" +--- + +## Browser spin-up time + +Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready. + +**Standard configuration** includes: +- Headful and headless browsers +- Stealth mode both enabled and disabled + +If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. + +## Connection notes + +- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. +- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. +- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. From 26deed436d3e512f7885dc5f05fc1be741176369 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 15:57:55 +0000 Subject: [PATCH 4/8] Update browsers/create-a-browser.mdx --- browsers/create-a-browser.mdx | 20 +------------------- 1 file changed, 1 insertion(+), 19 deletions(-) diff --git a/browsers/create-a-browser.mdx b/browsers/create-a-browser.mdx index 6a78299..8ce3406 100644 --- a/browsers/create-a-browser.mdx +++ b/browsers/create-a-browser.mdx @@ -142,22 +142,4 @@ async with async_playwright() as playwright: await browser.close() await kernel.browsers.delete_by_id(kernel_browser.session_id) ``` - - - -## Troubleshooting - -### Browser spin-up time - -Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready. - -**Standard configuration** includes: -- Headful and headless browsers -- Stealth mode both enabled and disabled - -If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. - -### Connection notes -- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. -- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. -- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. \ No newline at end of file + \ No newline at end of file From 8dc10fcc915b692f3ca4a0697ba47fffd0482b5c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 15:58:14 +0000 Subject: [PATCH 5/8] Update docs.json --- docs.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 2ef5560..fdcf122 100644 --- a/docs.json +++ b/docs.json @@ -84,7 +84,8 @@ "browsers/replays", "browsers/extensions", "browsers/computer-controls", - "browsers/playwright-execution" + "browsers/playwright-execution", + "browsers/faq" ] }, { From 34e6a02b860697189803dccdbd52fa509b8829a9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 16:05:32 +0000 Subject: [PATCH 6/8] Update browsers/faq.mdx --- browsers/faq.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/browsers/faq.mdx b/browsers/faq.mdx index 40ac6f3..dbd8fc2 100644 --- a/browsers/faq.mdx +++ b/browsers/faq.mdx @@ -3,7 +3,7 @@ title: "FAQ" description: "Frequently asked questions about Kernel browsers" --- -## Browser spin-up time +# Browser spin-up time Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready. From 199b4f371d482dfba579a45218f2f499c7d27b12 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 13 Nov 2025 16:05:37 +0000 Subject: [PATCH 7/8] Update browsers/faq.mdx --- browsers/faq.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/browsers/faq.mdx b/browsers/faq.mdx index dbd8fc2..2c4684f 100644 --- a/browsers/faq.mdx +++ b/browsers/faq.mdx @@ -13,7 +13,7 @@ Non-standard configuration can affect browser spin-up time. Settings like non-de If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. -## Connection notes +# Connection notes - **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. - Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. From a16af7ea09e3d3e087275e596d8d495d96682462 Mon Sep 17 00:00:00 2001 From: Catherine Jue Date: Mon, 17 Nov 2025 20:07:14 -0500 Subject: [PATCH 8/8] Add unsupported sites --- browsers/faq.mdx | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/browsers/faq.mdx b/browsers/faq.mdx index 2c4684f..61c0e98 100644 --- a/browsers/faq.mdx +++ b/browsers/faq.mdx @@ -3,7 +3,7 @@ title: "FAQ" description: "Frequently asked questions about Kernel browsers" --- -# Browser spin-up time +## Browser spin-up time Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready. @@ -13,8 +13,19 @@ Non-standard configuration can affect browser spin-up time. Settings like non-de If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay. -# Connection notes +## Connection notes - **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser. - Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected. - We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs. + +## Unsupported Websites + +There are some websites that are not supported by Kernel browsers due to their restrictions around automation and associated bot detection. These include: + +- LinkedIn +- Facebook +- Instagram +- X (Twitter) +- Amazon +- Reddit