Browser Pools - Kernel

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.

Flag	Description
`--output json`, `-o json`	Output raw JSON array.

Get details of a browser pool.

Flag	Description
`--output json`, `-o json`	Output raw JSON object.

Create a new browser pool.

Flag	Description
`--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-changes`	Save 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`).
`--headless`	Enable headless mode.
`--stealth`	Enable stealth mode.
`--kiosk`	Enable kiosk mode.
`--output json`, `-o json`	Output raw JSON object.

kernel browser-pools create my-pool --size 10 --fill-rate 5 --stealth

Update a browser pool’s configuration.

Flag	Description
`--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-url`	Clear the pool start URL.
`--discard-all-idle`	Discard all idle browsers.
`--profile-id <id>`	Profile ID to load into pool browsers.
`--profile-name <name>`	Profile name to load into pool browsers.
`--save-changes`	Save 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`).
`--headless`	Enable headless mode.
`--stealth`	Enable stealth mode.
`--kiosk`	Enable kiosk mode.
`--output json`, `-o json`	Output raw JSON object.

Acquire a browser from the pool.

Flag	Description
`--timeout <seconds>`	Acquire timeout in seconds.
`--output json`, `-o json`	Output raw JSON object.

Release a browser back to the pool.

Flag	Description
`--session-id <id>`	Browser session ID to release.
`--reuse`	Reuse the browser instance (default: `true`).

Delete a browser pool.

Flag	Description
`--force`	Force delete even if browsers are leased.

Flush idle browsers from the pool.