Practical Recipes

15.1 Embedded BrowserBox without the standard UI #

export ALLOWED_EMBEDDING_ORIGINS="https://app.example.com"
export BBX_HOME_PAGE="https://app.example.com"
bbx setup -p 8888
bbx start

Then use a login link shaped like:

https://localhost:8888/login?token=...&ui=false

15.2 BrowserBox behind a reverse proxy #

bbx stop
bbx setup --backend http -p 8080 --hostname browserbox.internal
bbx start

Then let nginx, Caddy, or a cloud load balancer terminate TLS and forward plain HTTP to BrowserBox.

If the deployment needs audio or DevTools, the edge must preserve a distinct origin per service rather than folding them onto one hostname — see Section 7.6 for the required layout.

15.3 Check whether a seat is currently available #

bbx vacancy

This command reports the current seat summary, including total seats, occupied seats, vacant seats, active leases, and active reservations.

Some deeper occupancy reporting may vary by deployment version.