Skip to main content
Manage pools of pre-warmed browsers for high-concurrency workloads. For background and scaling guidance, see Browser Pools.

kernel browser-pools list

List all browser pools.
FlagDescription
--output json, -o jsonOutput raw JSON array.

kernel browser-pools get <id-or-name>

Get details of a browser pool.
FlagDescription
--output json, -o jsonOutput raw JSON object.

kernel browser-pools create [name]

Create a new browser pool.
FlagDescription
--name <name>Optional unique name for the pool.
--size <n>Number of browsers in the pool.
--fill-rate <n>Fill rate per minute.
--timeout <seconds>Idle timeout in seconds.
--start-url <url>Initial page to open for new browsers.
--profile-id <id>Profile ID to load into pool browsers.
--profile-name <name>Profile name to load into pool browsers.
--save-changesSave changes back to the profile when sessions end.
--proxy-id <id>Proxy ID to use for pool browsers.
--extension <id-or-name>Extension IDs or names to load (repeatable).
--viewport <size>Viewport size (e.g. 1280x800).
--headlessEnable headless mode.
--stealthEnable stealth mode.
--kioskEnable kiosk mode.
--output json, -o jsonOutput raw JSON object.
kernel browser-pools create my-pool --size 10 --fill-rate 5 --stealth

kernel browser-pools update <id-or-name>

Update a browser pool’s configuration.
FlagDescription
--name <name>Update the pool name.
--size <n>Updated pool size.
--fill-rate <n>Fill rate per minute.
--timeout <seconds>Idle timeout in seconds.
--start-url <url>Initial page to open for new browsers.
--clear-start-urlClear the pool start URL.
--discard-all-idleDiscard all idle browsers.
--profile-id <id>Profile ID to load into pool browsers.
--profile-name <name>Profile name to load into pool browsers.
--save-changesSave changes back to the profile when sessions end.
--proxy-id <id>Proxy ID to use for pool browsers.
--extension <id-or-name>Extension IDs or names to load (repeatable).
--viewport <size>Viewport size (e.g. 1280x800).
--headlessEnable headless mode.
--stealthEnable stealth mode.
--kioskEnable kiosk mode.
--output json, -o jsonOutput raw JSON object.

kernel browser-pools acquire <id-or-name>

Acquire a browser from the pool.
FlagDescription
--timeout <seconds>Acquire timeout in seconds.
--output json, -o jsonOutput raw JSON object.

kernel browser-pools release <id-or-name>

Release a browser back to the pool.
FlagDescription
--session-id <id>Browser session ID to release.
--reuseReuse the browser instance (default: true).

kernel browser-pools delete <id-or-name>

Delete a browser pool.
FlagDescription
--forceForce delete even if browsers are leased.

kernel browser-pools flush <id-or-name>

Flush idle browsers from the pool.