> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-update-create-pool-guidance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Pools

Manage pools of pre-provisioned browsers for high-concurrency workloads. For background and scaling guidance, see [Browser Pools](/browsers/pools).

## `kernel browser-pools list`

List all browser pools.

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

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

Get details of a browser pool.

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

## `kernel browser-pools create [name]`

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. |

```bash theme={null}
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.

| 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. |

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

Acquire a browser from the pool.

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

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

Release a browser back to the pool.

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

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

Delete a browser pool.

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

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

Flush idle browsers from the pool.