Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt

Use this file to discover all available pages before exploring further.

Browser Use Box is a self-hosted Linux box agent for Browser Use Cloud. It keeps a Browser Use profile online, accepts tasks from Telegram, and can keep working in the background while you are away. Use it when you want a personal agent that can:
  • run on your own VPS or spare Linux machine
  • control a real Browser Use Cloud browser with persistent cookies
  • resume work from Telegram forum topics
  • schedule recurring checks with cron, at, or tg-schedule
  • hand off login walls, 2FA, CAPTCHA, and Cloudflare through the live browser URL
Watch the short setup and usage demo on TikTok: Browser Use Box demo.

​
Setup

Clone the repo and follow the install guide: 
git clone https://github.com/browser-use/bux
cd bux
See the full install path in the Browser Use Box README and install guide.

​
Browser Use Cloud

Browser Use Box uses a long-lived Browser Use Cloud browser session instead of launching local Chrome. The box stores the active CDP WebSocket, live browser URL, profile ID, and browser ID in its browser environment file so agents can reconnect between tasks. Typical browser automation from the box looks like this: 
source ~/.claude/browser.env
browser-harness-js 'await session.connect({wsUrl: process.env.BU_CDP_WS}); await session.Page.navigate({url: "https://example.com"})'
Cookies persist through the bound Browser Use profile. When a site needs a human step, the agent shares the live browser URL and waits for the user to finish the login or challenge.

​
Telegram Control

Browser Use Box turns Telegram topics into parallel agent sessions. Each topic gets its own working context, while the Linux box keeps long-running work, schedules, and browser state available across turns. Example prompts:
  • monitor my Gmail every 30 minutes and draft replies
  • watch this PR and tell me when CI is green
  • use the browser to update this dashboard
  • schedule a daily startup metrics brief

​
Learn More