diff --git a/browsers/pools/overview.mdx b/browsers/pools/overview.mdx index 3a131c7d..a5894910 100644 --- a/browsers/pools/overview.mdx +++ b/browsers/pools/overview.mdx @@ -1,9 +1,11 @@ --- title: "Overview" -description: "Pre-configure pools of reserved browsers for immediate acquisition" +description: "Pre-configure pools of reserved browsers" --- -Browser pools let you maintain a set of reserved, identical browsers ready for immediate use. Use them to set your preferred browser configuration in advance, allowing you to minimize browser start-up latency and scale your workloads in production. +Browser pools let you maintain a set of reserved, identical browsers ready for immediate use. Use them to set your preferred browser configuration in advance (such as stealth, proxies, extensions, and profiles), allowing you to minimize browser start-up latency and scale your workloads in production. + +Acquiring a browser from a pool is faster than creating a browser directly. Reserved browsers and on-demand browsers share the same concurrency limit, and reserved browsers aren't billed until they're used. See [Scale](/introduction/scale) for how pools fit into best practices for production architecture. ## How browser pools work @@ -27,7 +29,7 @@ Browser pools are a way to pre-configure a fixed set of browsers without being c - When you're done with a browser, release it back to the pool. this step is important; otherwise, the browser will continue to be in an `acquired` state until it times out. + When you're done with a browser, release it back to the pool. This step is important; otherwise, the browser will continue to be in an `acquired` state until it times out. Failing to release browsers may result in unexpected latency when acquiring future browsers. diff --git a/changelog.mdx b/changelog.mdx index 93f021e0..44f1dd97 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -369,7 +369,7 @@ For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-n - We released [skills](https://skills.sh/?q=kernel/skills) for Kernel, so you can easily build browser agents directly from Claude Code. ## Documentation updates -- We published a [Scaling in Production guide](/browsers/pools/scaling) with recommendations and best practices for handling high-concurrency workloads. Read it to learn how and when to use browser pools versus on-demand browsers, and see code samples for production implementations. +- We published a [Scaling in Production guide](/introduction/scale) with recommendations and best practices for handling high-concurrency workloads. Read it to learn how and when to use browser pools versus on-demand browsers, and see code samples for production implementations. - Added a new [integration guide](https://www.kernel.sh/docs/integrations/agent-browser) for [Agent Browser](https://github.com/vercel-labs/agent-browser), Vercel's headless browser automation CLI, which has built-in support for Kernel browsers. diff --git a/docs.json b/docs.json index 4e29c75c..d9532e35 100644 --- a/docs.json +++ b/docs.json @@ -13,6 +13,7 @@ { "source": "/browsers/hardware-acceleration", "destination": "/browsers/gpu-acceleration" }, { "source": "/integrations/computer-use", "destination": "/integrations/computer-use/overview" }, { "source": "/browsers/create-a-browser", "destination": "/introduction/create" }, + { "source": "/browsers/pools/scaling", "destination": "/introduction/scale" }, { "source": "/introduction", "destination": "/" }, { "source": "/quickstart", "destination": "/" }, { "source": "/home", "destination": "/" }, @@ -73,7 +74,8 @@ "index", "introduction/create", "introduction/control", - "introduction/observe" + "introduction/observe", + "introduction/scale" ] }, { @@ -162,7 +164,6 @@ "pages": [ "browsers/pools/overview", "browsers/pools/policy-json", - "browsers/pools/scaling", "browsers/pools/faq" ] } diff --git a/browsers/pools/scaling.mdx b/introduction/scale.mdx similarity index 98% rename from browsers/pools/scaling.mdx rename to introduction/scale.mdx index d293a589..ae255006 100644 --- a/browsers/pools/scaling.mdx +++ b/introduction/scale.mdx @@ -1,6 +1,6 @@ --- -title: "Scaling in Production" -description: "Recommended practices for scaling" +title: "Scale" +description: "Recommended practices for scaling in production" --- ## Introduction diff --git a/style.css b/style.css index cc256401..4ad20ae4 100644 --- a/style.css +++ b/style.css @@ -247,4 +247,4 @@ html.dark .callout[class*="yellow"] svg { .dark .card:hover { border-color: rgb(223 223 223) !important; -} \ No newline at end of file +}