Configure Overview

​

Create a browser

import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const browser = await kernel.browsers.create();
console.log(browser.session_id, browser.browser_live_view_url);

from kernel import Kernel

kernel = Kernel()

browser = kernel.browsers.create()
print(browser.session_id, browser.browser_live_view_url)

package main

import (
	"context"
	"fmt"

	"github.com/kernel/kernel-go-sdk"
)

func main() {
	ctx := context.Background()
	client := kernel.NewClient()

	browser, err := client.Browsers.New(ctx, kernel.BrowserNewParams{})
	if err != nil {
		panic(err)
	}
	fmt.Println(browser.SessionID, browser.BrowserLiveViewURL)
}

kernel browsers create

​

Pick a browser type

​

Set common options

const browser = await kernel.browsers.create({
  viewport: { width: 1280, height: 800 },
  timeout_seconds: 300,
});

browser = kernel.browsers.create(
    viewport={"width": 1280, "height": 800},
    timeout_seconds=300,
)

• Viewport: defaults to 1920x1080 at 25Hz. A custom viewport restarts Chromium on creation, so use a browser pool if you need it to be instant.
• Standby: after 5 seconds with no CDP, WebDriver, live view, or computer controls activity, a browser goes into standby. It keeps its state and stops accruing usage cost until something reconnects.
• Termination and timeouts: timeout_seconds sets how long a browser can sit in standby before KERNEL deletes it. It defaults to 60 seconds and can be up to 72 hours. Delete browsers explicitly when you’re done; Playwright’s browser.close() doesn’t delete them.

​

More browser settings

• Regions: run browsers in us-east, eu-west, or ap-southeast, closer to your code and your users.
• Extensions: load unpacked Chrome extensions into a browser.
• Chrome policies: apply Chrome enterprise policies, such as startup pages and bookmarks.
• Private networking: reach services behind a VPN or tunnel from inside the browser session.

​

What to configure next