Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions browsers/standby.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "Standby Mode"

Kernel browsers enter standby mode during periods of inactivity. When a browser goes into standby mode, the browser's state remains the same but incurs zero usage costs.

Kernel browsers automatically enter standby after `five seconds` with no activity. After it enters standby, the browser's [timeout](/browsers/termination#automatic-deletion-via-timeout) countdown begins.
Kernel browsers automatically start entering standby after `ten seconds` with no activity. After it enters standby, the browser's [timeout](/browsers/termination#automatic-deletion-via-timeout) countdown begins.

A browser is considered active while any of the following is happening:

Expand All @@ -14,7 +14,7 @@ A browser is considered active while any of the following is happening:
- A [telemetry stream](/browsers/telemetry/streaming) is connected
- A [computer controls](/browsers/computer-controls) API request is in flight (clicks, keypresses, screenshots, etc.)

Any of the above resets the standby idle timer. As soon as none are active for five seconds, the browser enters standby.
Any of the above resets the standby idle timer. Once none are active for ten seconds, the browser starts entering standby. That's the minimum idle time before standby can start. Usage is billed until the transition completes, which may take several more seconds.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

10 is the correct number, it's not 5. Also there is some wiggle room on when it stops exactly, for example if there are queued standbys on a busy host.


<Info>
See [here](/browsers/termination) to learn about destroying browsers. GPU-accelerated browsers do not support standby mode.
Expand Down
2 changes: 1 addition & 1 deletion index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ a unikernel carries the browser and nothing else, so there's little to boot or k

- **lifecycle actions are fast.** a browser is created in about 30ms at p50 and 105ms at p99 ([benchmarks](https://www.kernel.sh/benchmarks)), so you can create one per task instead of keeping a warm pool alive to hide start-up time.
- **code on the vm is safe to hand an agent.** every browser is its own vm, isolated at the hypervisor rather than sharing a host kernel with other tenants, so the [browser repl](/browsers/repl), [process execution](/browsers/process-execution), and root access over [ssh](/browsers/ssh) stay contained to that session.
- **idle browsers go into standby.** five seconds after the last client disconnects, a browser enters [standby](/browsers/standby): it keeps its state and stops accruing usage cost until a client reconnects.
- **idle browsers go into standby.** ten seconds after the last client disconnects, a browser starts entering [standby](/browsers/standby): it keeps its state and stops accruing usage cost until a client reconnects.

## open source

Expand Down
2 changes: 1 addition & 1 deletion integrations/docker-sandboxes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ The kit tells your agent to delete browsers when it's done. To delete a browser
sbx exec kernel-demo kernel browsers delete <session-id>
```

A browser with nothing connected to it enters [standby](/browsers/standby) after five seconds, which stops billing, and Kernel deletes it when its timeout elapses (60 seconds by default). See [Termination & timeouts](/browsers/termination) for details.
A browser with nothing connected to it starts entering [standby](/browsers/standby) after ten seconds, which stops billing, and Kernel deletes it when its timeout elapses (60 seconds by default). See [Termination & timeouts](/browsers/termination) for details.

Besides your stored key and its approval in `credentials.yaml`, the kit doesn't leave anything on your host. To remove your key and the sandbox, run:

Expand Down
2 changes: 1 addition & 1 deletion introduction/create.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ An acquired browser returns the same fields as one you created directly, so the

## Lifecycle

A browser stays alive as long as something is driving it — a CDP or WebDriver client, a [Live View](/browsers/live-view) viewer, or an in-flight [computer controls](/browsers/computer-controls) request. After five seconds with none of those active, it enters [standby](/browsers/standby) — state is preserved, billing stops. Once in standby, after the configurable timeout (60s by default) elapses it's deleted.
A browser stays alive as long as something is driving it — a CDP or WebDriver client, a [Live View](/browsers/live-view) viewer, or an in-flight [computer controls](/browsers/computer-controls) request. After ten seconds with none of those active, it starts entering [standby](/browsers/standby) — state is preserved, billing stops. Once in standby, after the configurable timeout (60s by default) elapses it's deleted.

We recommend you delete a browser explicitly when you're done with it:

Expand Down
2 changes: 1 addition & 1 deletion overview/why-kernel.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ You can. Running one Chrome locally is easy, and it's the right call while you'r
| Isolation | Keep one session's page, files, and processes away from every other session on the same host | Each browser is a [microVM](/info/unikernels) with its own kernel and filesystem |
| Bot detection | You maintain the patches, the fingerprints, and a proxy contract | [Anti-detection](/browsers/bot-detection/overview) on every browser, plus a managed solver and [proxies](/proxies/overview), including bring-your-own |
| Sensitive credentials | Keep passwords and card details out of your agent's context and logs, and run the secret store that holds them | [Vaults](/vaults/overview) store sensitive information and fill it into the page without the values passing through your agent, [managed auth](/auth/overview) handles logins end to end, and [profiles](/browsers/profiles) persist state across sessions |
| Idle cost | Avoid paying for a running browser while you wait for end-user input | [Standby mode](/browsers/standby) suspends the browser and stops usage charges 5 seconds after the last client disconnects |
| Idle cost | Avoid paying for a running browser while you wait for end-user input | [Standby mode](/browsers/standby) starts suspending the browser 10 seconds after the last client disconnects, which stops usage charges |
| Debugging a failure | Add your own logging and screen recording, then try to reproduce the failure | [Live view](/browsers/live-view), [replays](/browsers/replays), and [telemetry](/browsers/telemetry/overview) for the session that actually failed |
| Scaling | Provision more hosts, then build the autoscaling, image pipeline, and cleanup jobs around them | [Upgrade your plan](/info/pricing) to raise your [concurrency limit and browser create rate](/browsers/concurrency-and-limits), with custom limits on Enterprise. |

Expand Down
Loading