dvcrn Ubuntu Browser Session
Reusable browser-session workflow for Ubuntu Server hosts.
When To Use
- Open or inspect a page from a headless Ubuntu Server host
- Reuse a previously verified browser session instead of starting fresh
- Ask the user for one bounded round of assisted login when local reuse is not enough
- Inspect visible page state from the host after the browser session is ready
Workflow
Preferred entrypoint:
{baseDir}/scripts/open-protected-page.sh --url 'https://target.example' --session-key default
Use lower-level helpers only when you need to inspect or repair an individual stage:
{baseDir}/scripts/session-manifest.sh select --origin 'https://target.example'
{baseDir}/scripts/browser-runtime.sh verify --origin 'https://target.example' --session-key default
{baseDir}/scripts/assisted-session.sh start --url 'https://target.example' --origin 'https://target.example' --session-key default
Environment Requirements
command -v python3
command -v curl
command -v jq
command -v Xvfb
command -v x11vnc
command -v websockify
command -v google-chrome || command -v chromium || command -v chromium-browser
Key Files
scripts/open-protected-page.sh: high-level session orchestrationscripts/browser-runtime.sh: browser runtime managementscripts/assisted-session.sh: assisted browser session overlayscripts/session-manifest.sh: session record managementscripts/cdp-eval.py: host-side page inspection helper
See also:
references/session-manifest.mdreferences/assisted-session-flow.md