{"id":14984254,"url":"https://github.com/browserbox/browserbox","last_synced_at":"2026-04-26T11:03:48.311Z","repository":{"id":40848010,"uuid":"222240688","full_name":"BrowserBox/BrowserBox","owner":"BrowserBox","description":"💚 Secure remote browsing anywhere, any way you like it. ","archived":false,"fork":false,"pushed_at":"2026-04-22T12:33:20.000Z","size":10600,"stargazers_count":3825,"open_issues_count":0,"forks_count":403,"subscribers_count":24,"default_branch":"main","last_synced_at":"2026-04-22T14:33:13.178Z","etag":null,"topics":["browser","cdr","chrome","cobrowsing","cybersecurity","embeddable","hidden-services","multiplayer","onion-service","proxy-server","rbi","remote-browser-isolation","remote-browsers","reverse-proxy","sanitization","tor","web-browser","web-isolation","webrtc","zero-trust"],"latest_commit_sha":null,"homepage":"https://browserbox.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BrowserBox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":"https://browse.cloudtabs.net/l"}},"created_at":"2019-11-17T11:55:36.000Z","updated_at":"2026-04-22T14:17:54.000Z","dependencies_parsed_at":"2026-02-04T19:04:05.029Z","dependency_job_id":"4f839627-0168-4fd5-beb6-9df9724a383c","html_url":"https://github.com/BrowserBox/BrowserBox","commit_stats":{"total_commits":1994,"total_committers":5,"mean_commits":398.8,"dds":"0.19658976930792382","last_synced_commit":"90d884260c9c0fc25493dfdfc20517f83943816d"},"previous_names":["crisdosyago/browserbox","dosyago/supreme-architect","i5ik/viewfinder","dosyago/browserboxpro","crisdosyago/viewfinder","dosyago/browsergap","dosyago/browserbox","cris691/viewfinder","dosyago/remoteview","dosyago/oni"],"tags_count":492,"template":false,"template_full_name":null,"purl":"pkg:github/BrowserBox/BrowserBox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrowserBox%2FBrowserBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrowserBox%2FBrowserBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrowserBox%2FBrowserBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrowserBox%2FBrowserBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BrowserBox","download_url":"https://codeload.github.com/BrowserBox/BrowserBox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BrowserBox%2FBrowserBox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32294592,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","cdr","chrome","cobrowsing","cybersecurity","embeddable","hidden-services","multiplayer","onion-service","proxy-server","rbi","remote-browser-isolation","remote-browsers","reverse-proxy","sanitization","tor","web-browser","web-isolation","webrtc","zero-trust"],"created_at":"2024-09-24T14:08:43.710Z","updated_at":"2026-04-26T11:03:48.301Z","avatar_url":"https://github.com/BrowserBox.png","language":"Shell","funding_links":["https://browse.cloudtabs.net/l"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"icon.svg\" alt=\"BrowserBox Logo\" width=\"111\" height=\"111\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eBrowserBox by DOSAYGO\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eSecure, modern Remote Browser Isolation (RBI) with a clientless experience\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://dosaygo.com#license\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Required-red\" alt=\"License Required\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dosaygo.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/BrowserBox-Secure%20RBI-blue\" alt=\"BrowserBox Secure RBI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dosaygo.com/nist800-53.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/NIST%20800--53-Alignment-green\" alt=\"NIST 800-53 Alignment\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dosaygo.com/hipaa.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/HIPAA-Ready-purple\" alt=\"HIPAA Ready\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dosaygo.com/dlp.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/DLP-Options-pink\" alt=\"DLP Options\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://github.com/BrowserBox/BrowserBox/actions/workflows/bbx-saga.yaml\"\u003e\u003cimg src=\"https://github.com/BrowserBox/BrowserBox/actions/workflows/bbx-saga.yaml/badge.svg?event=release\u0026fuck=cust\" alt=\"bbx Saga Test Suite\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Try BrowserBox with our nostalgic \u003ca href=\"https://win9-5.com/demo\"\u003eWindows 98½ demo\u003c/a\u003e — free 17-minute cloud browser sessions, no signup required.\u003cbr\u003e\n  \u003cstrong\u003eCloud API:\u003c/strong\u003e Purchase minutes and create on-demand cloud browser sessions via REST API.\u003cbr\u003e\n  \u003ca href=\"https://win9-5.com/api/\"\u003eAPI Docs\u003c/a\u003e · \u003ca href=\"https://win9-5.com/pricing/\"\u003ePricing\u003c/a\u003e · \u003ca href=\"https://win9-5.com/demo\"\u003eLive Demo\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nBrowserBox is a remote browser isolation (RBI) platform. It streams a full, modern browser to any client — 60 FPS, low latency — and runs on Windows, Linux, and containers. **A product key is required for all self-hosted usage.**\n\n**At a glance:**\n- Clientless RBI — no plugins, no downloads for end users\n- 60 FPS streaming with real responsiveness\n- Embeds anywhere via `\u003cbrowserbox-webview\u003e`\n- Cloud API for ephemeral sessions, no self-hosting needed\n- Works on Windows, Linux, and containers like Podman, and LXC\n- Policy controls, DLP, and audit-friendly workflows\n\n[ASCIInema Recordings](https://asciinema.org/~dosaygo) | [Live Demo](https://win9-5.com/demo) | [Cloud API](https://win9-5.com/api/) | [Pricing](https://win9-5.com/pricing/) | [Customer Guide](./docs/BrowserBox_Customer_Guide_v16.9.0.pdf) | [Support](mailto:api@browserbox.io)\n\nOfficial sites: [BrowserBox](https://browserbox.io), [DOSAYGO](https://dosaygo.com), [CloudTabs](https://browse.cloudtabs.net)\n\n\n\n---\n\n\u003e **Notice: Legacy source code removed (March 2026)**\n\u003e\n\u003e When BrowserBox transitioned to a binary distribution model in late 2025, we retained legacy source code in this repository for a six-month period to give existing customers time to migrate. That period is now over and all legacy source has been removed.\n\u003e\n\u003e Current BrowserBox source is private and proprietary. It diverges significantly from the legacy code that was previously housed here -- by over 1,000 commits -- with extensive bug fixes, security hardening, and performance enhancements that are absent from the legacy codebase and any forks thereof.\n\u003e\n\u003e Legacy source code may still be visible in third-party forks as a historical curiosity. That code is **not open source**. Permission is **not** granted to use that source in your products, to train AI models, or to re-implement BrowserBox functionality from it. These acts violate BrowserBox terms. See [LICENSE.md](LICENSE.md) and [TRADEMARK.md](TRADEMARK.md).\n\u003e\n\u003e Current source is available to customers above a threshold ACV as part of due diligence, on request. Contact [sales@dosaygo.com](mailto:sales@dosaygo.com).\n\n---\n\n## Table of Contents\n\n1. [Why BrowserBox?](#1-why-browserbox)\n2. [Key Benefits](#2-key-benefits)\n3. [Who Uses It](#3-who-uses-it)\n4. [Real-World Use Cases](#4-real-world-use-cases)\n5. [Core Features](#5-core-features)\n6. [What's New](#6-whats-new)\n7. [See It In Action](#7-see-it-in-action)\n8. [Supported Network Topologies](#8-supported-network-topologies)\n9. [Platform Compatibility](#9-platform-compatibility)\n10. [Install](#10-install)\n11. [Quick Start](#11-quick-start)\n12. [Documentation](#12-documentation)\n13. [GitHub Actions](#13-github-actions)\n14. [Cloud API](#14-cloud-api)\n15. [Embed BrowserBox](#15-embed-browserbox)\n16. [Advanced Usage](#16-advanced-usage)\n17. [License Compliance \u0026 Privacy](#17-license-compliance--privacy)\n18. [FAQ](#18-faq)\n19. [Licensing](#19-licensing)\n20. [Support](#20-support)\n21. [About DOSAYGO](#21-about-dosaygo)\n\n---\n\n## 1. Why BrowserBox?\n\nThe web is genuinely dangerous, and standard browsing pushes that risk directly onto your network and your endpoints. BrowserBox flips the model: the browser runs on a server you control, and clients receive a rendered stream — so malware, exploits, and sketchy sites never touch user devices. Security teams get isolation without fighting users over endpoint agents. SaaS builders can embed a full browsing experience into their products without headless brittleness. Regulated organizations get audit trails and DLP controls baked in.\n\n- Threat containment: browser exploits hit the server, not the endpoint\n- True clientless access: any modern browser, zero installs for end users\n- Embeddable: build web products that include real, live browsing\n- Automation-ready: a real browser, not a headless approximation\n\n---\n\n## 2. Key Benefits\n\n- **Threat isolation:** malware, exploits, and bad sites hit the server — not client devices\n- **Clientless:** works in any browser, zero install for end users\n- **Cross-platform:** Windows, Linux (Debian, Ubuntu, RHEL, CentOS, NixOS), and containers like LXC\n- **Smooth UX:** low-latency rendering, 60 FPS\n- **Solid CLI and embedding API** for builders and integrators\n\n---\n\n## 3. Who Uses It\n\n- **Security teams** — isolate browsing risk from corporate endpoints\n- **SaaS builders and integrators** — embed live browser sessions in products\n- **IT and ops** — access internal web UIs from anywhere, without broad network exposure\n- **Automation and QA** — run real browser workflows without headless fragility\n- **Regulated orgs** — healthcare, finance, government — where audit trails and DLP policies aren't optional\n\n---\n\n## 4. Real-World Use Cases\n\n### Home Lab: The Always-On Jump Browser\n\nIf you run a Synology NAS or any always-on home server, BrowserBox fits in naturally as a private jump browser for your local network. Install it once via CLI, and you've got a streamed Chrome session you can reach from any device — phone, laptop, whatever's in your hand — that can immediately access your router admin panel, IP cameras, smart home hubs, printers, and any other internal web UI that normally requires being on the same LAN.\n\nNo port forwarding maze. No VPN just to check one device. You expose a single protected BrowserBox session, secured by token, and everything behind it stays private. Trigger large downloads and they land directly on NAS drives — no extra hops, no cloud middleman. When a site throws a captcha or anti-bot wall, just handle it visually in the remote browser. It's your network. This is how you reach it cleanly.\n\n### Enterprise: Secure Remote Browser Gateway\n\nIn corporate, government, healthcare, and financial environments, BrowserBox acts as a secure browser gateway deployed inside a protected network. Teams, contractors, and vendors reach internal web applications, intranets, admin panels, and legacy systems — without installing software on their devices or opening broad network access to your infrastructure.\n\nAdmins control copy-paste, file uploads and downloads, printing, and keyboard inputs per user or session. DLP policies keep sensitive information contained inside the isolated browser. Every action is auditable. Malware and exploits are contained server-side. Whether you're managing compliance with HIPAA, financial regulations, or government security requirements, the controls are there — and they're not bolted on as an afterthought.\n\nSame core idea, two very different worlds: keep the browser where you can watch it, and stream the view to wherever people actually are.\n\n---\n\n## 5. Core Features\n\n- **Clientless RBI** — access from any modern browser, no install required for end users\n- **Cross-platform** — Windows, Debian, Ubuntu, RHEL, Rocky Linux, CentOS, NixOS, and containers like LXC\n- **`bbx` CLI** — manage install, licenses, users, run modes, and tunnels from the command line\n- **`\u003cbrowserbox-webview\u003e` embedding API** — drop a live browser session into any web product\n- **Cloud API** — purchase minute packs and spin up ephemeral sessions via REST, no self-hosting\n- **Automation-ready** — a real browser; Puppeteer and Playwright integrations coming\n- **DLP, Tor support, access controls** — policy enforcement built in, not bolted on\n- **1-click cloud deployment** — coming soon\n\n---\n\n## 6. What's New\n\n- **Cloud API** — purchase minute packs at [win9-5.com/pricing](https://win9-5.com/pricing/) and create ephemeral browser sessions via REST. No server to manage.\n- **Windows 98½ Demo** — free 17-minute cloud sessions at [win9-5.com/demo](https://win9-5.com/demo), no signup.\n- **Flipbook Recording** — record any browsing session as a self-contained static flipbook site. Deploy to Cloudflare Pages with one command.\n- **Binary release system** — BrowserBox now ships as a signed binary. Install with one command, update the same way.\n- **60 FPS streaming** — real-time, low-latency rendering for a browsing experience that actually feels like a browser.\n- **Unified install endpoints** — `browserbox.io/install.sh` (Linux/macOS) and `browserbox.io/install.ps1` (Windows).\n\n---\n\n## 7. See It In Action\n\n\u003cdiv align=\"center\"\u003e\n  \u003cfigure style=\"display: inline-block; margin: 10px;\"\u003e\n    \u003cimg width=\"600\" alt=\"BrowserBox displays the web, like a normal browser, but enterprise secure.\" src=\"https://github.com/user-attachments/assets/22150497-a6c9-4e05-9770-e9f5e7196c61\" /\u003e\n    \u003cfigcaption\u003eSecure Web Browsing\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display: inline-block; margin: 10px;\"\u003e\n    \u003cimg width=\"600\" alt=\"BrowserBox displays PDFs like a normal browser.\" src=\"https://github.com/user-attachments/assets/45240ca9-3f1d-458f-9d92-d05cfb14f991\" /\u003e\n    \u003cfigcaption\u003eSeamless PDF Viewing\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display: inline-block; margin: 10px;\"\u003e\n    \u003cimg width=\"600\" alt=\"BrowserBox has DevTools like a normal browser\" src=\"https://github.com/user-attachments/assets/a6457338-117a-44ee-8ab8-87dafa471f11\" /\u003e\n    \u003cfigcaption\u003ePowerful DevTools\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display: inline-block; margin: 10px;\"\u003e\n    \u003cimg width=\"600\" alt=\"BrowserBox uploads files, and does many other things, just like a normal browser.\" src=\"https://github.com/user-attachments/assets/a70608cd-30d7-48ad-a707-4bacfc6d9a73\" /\u003e\n    \u003cfigcaption\u003eFull Browser Features (File Uploads, etc.)\u003c/figcaption\u003e\n  \u003c/figure\u003e\n\u003c/div\u003e\n\n---\n\n## 8. Supported Network Topologies\n\nBrowserBox isn't fussy about how your network is wired. Whether you're behind a corporate NAT, routing through Tor, or running a Cloudflare tunnel for a quick demo, it fits in without requiring you to restructure anything. The table below covers the supported topologies — pick what matches your situation.\n\n| Topology | Description | Public Access? | Key Features \u0026 Benefits | OS Support (Ubuntu/macOS/Windows) | Best For |\n|----------|-------------|----------------|--------------------------|------------------------------------|----------|\n| **HTTP Only** | Basic unencrypted HTTP connections for quick, lightweight access. | Yes (if exposed) | Simple setup; ideal for internal testing or low-security demos. Supports custom ports (e.g., 8080, 9999, 11111) or standard (80). | ✅ / ✅ / ✅ | Rapid prototyping in trusted networks. |\n| **HTTP/WS** | HTTP with WebSocket support for real-time bidirectional communication. | Yes (if exposed) | Enables interactive apps; pairs with custom/standard ports for flexibility. | ✅ / ✅ / ✅ | Chat apps, live updates, or collaborative tools. |\n| **HTTPS/WSS/WebRTC** | Secure HTTPS with WebSocket Secure and WebRTC for encrypted, peer-to-peer media streaming. | Yes (if exposed) | End-to-end encryption; auto-cert handling; custom/standard ports (443 default). | ✅ / ✅ / ✅ | Video calls, secure file sharing, or real-time collaboration in production. |\n| **Tor/HTTP** | Tor onion service over HTTP for pseudonymous access. | Yes (via .onion) | High privacy; bypasses censorship; slow but reliable. Requires Tor Browser. | ✅ / ✅ / ✅ | Privacy-focused demos or restricted environments. |\n| **Tor/HTTPS** | Secure Tor onion service with HTTPS encryption. | Yes (via .onion) | Adds TLS to Tor for extra security; reliable NAT traversal. | ✅ / ✅ / ✅ | Anonymous secure access in high-threat scenarios. |\n| **SSH Port Forward, HTTP** | SSH-based port forwarding tunneling HTTP traffic. | No (private) | Secure, low-latency; forwards to custom/standard ports. Upcoming auto-cert orchestration. | ✅ / ✅ / ✅ | Private homelab access or secure internal routing. |\n| **SSH Port Forward, HTTPS** | SSH forwarding with HTTPS for encrypted tunnels. | No (private) | Combines SSH reliability with TLS; flexible port options. Native enhancements incoming. | ✅ / ✅ / ✅ | Enterprise-grade secure remote sessions. |\n| **Custom Ports** | User-defined ports (e.g., 8080, 9999, 11111) across any protocol. | Varies | Total control; avoids conflicts; integrates with all topologies. | ✅ / ✅ / ✅ | Tailored setups for specialized apps or multi-service hosts. |\n| **Standard Ports** | Default ports (e.g., 80 for HTTP, 443 for HTTPS) for seamless compatibility. | Varies | Plug-and-play; reduces config overhead in standard environments. | ✅ / ✅ / ✅ | Quick deployments matching common infrastructure. |\n| **Cloudflare Tunnel** | HTTPS DNS facade with port relay via Cloudflare's edge network. | Yes (*.trycloudflare.com) | Auto-install; high reliability; great perf. Native `bbx cf-run` support soon. | ✅ / ✅ / ✅ | Quick public demos with origin privacy. |\n| **localhost.run** | SSH reverse tunnel with HTTPS facade. | Yes (http(s)://…lhr.life) | Zero-config; medium reliability; occasional interstitials. | ✅ / ✅ / ✅ | Free, easy links for casual sharing. |\n| **ngrok** | Port relay with HTTPS and auth token for secure exposure. | Yes (*.ngrok-free.app) | High perf; webhooks ready; free tier limits (1 tunnel). Token required. | ✅ / ✅ / ✅ | Shareable demos and webhook testing. |\n| **Pinggy** | Port relay with HTTPS; may have interstitials. | Yes (*.pinggy.io) | Fair reliability; okay perf. | ✅ / ✅ / ℹ️ (Limited on Windows) | Budget-friendly webhooks and demos. |\n| **Tailscale** | Overlay network for private, LAN-like access. | No (private tailnet) | Very high reliability; low latency. SSH forwarding; token required. Less stable on Windows/VPN. | ✅ / ✅ / ℹ️ (SSH not upstream-supported on Windows) | Private team debugging and access. |\n| **Tor** | Onion routing for pseudonymous, reliable access. | Yes (.onion) | Extremely reliable (but slow); privacy-first. We already have `bbx tor-run`. | ✅ / ✅ / ✅ | Censorship-resistant, anonymous deployments. |\n| **Tunnelmole** | OSS ngrok-style relay with HTTPS. | Yes (https://…tunnelmole.net/.com) | High reliability; good perf; auto-install. | ✅ / ✅ / ✅ | Open-source demos with easy URLs. |\n| **ZeroTier** | Overlay network for peer-to-peer private access. | No (private network) | LAN-like; very high reliability. Native `bbx zt-run` support soon. Tokens required; client on access device. | ✅ / ✅ / ✅ | Secure P2P demos in overlays. |\n\n**Notes on Flexibility \u0026 Power:**\n- BrowserBox supports mixing and matching topologies — you can run HTTPS with a Cloudflare tunnel on custom ports, or Tor over SSH forwarding. The topology is yours to compose.\n- The `bbx` CLI handles tunnel setup, cert orchestration, and run modes in one place, so you're not stitching together a dozen separate tools to get a working deployment.\n\n---\n\n## 9. Platform Compatibility\n\nBrowserBox runs where real work happens — here's the current support matrix.\n\n| Platform                 | Supported | Icon |\n| :----------------------- | :-------- | :--- |\n| Tails\\*                  | ❌        | \u003cimg src=\"readme-files/tails.svg\" alt=\"Tails\" width=\"100\" title=\"Tails OS\"\u003e |\n| Windows \u0026 Windows Server | ✅        | \u003cimg src=\"readme-files/windows.svg\" alt=\"Windows\" width=\"100\" title=\"Windows and Windows Server\"\u003e |\n| Debian                   | ✅        | \u003cimg src=\"readme-files/debian.svg\" alt=\"Debian\" width=\"64\" title=\"Debian\"\u003e |\n| Ubuntu                   | ✅        | \u003cimg src=\"readme-files/ubuntu.svg\" alt=\"Ubuntu\" width=\"100\" title=\"Ubuntu\"\u003e |\n| CentOS Stream            | ✅        | \u003cimg src=\"readme-files/centos.svg\" alt=\"CentOS Stream\" width=\"100\" title=\"CentOS Stream\"\u003e |\n| RHEL                     | ✅        | \u003cimg src=\"readme-files/rhel.svg\" alt=\"Red Hat Enterprise Linux\" width=\"100\" title=\"RHEL\"\u003e |\n| Rocky Linux              | ✅        | \u003cimg src=\"readme-files/rockylinux.svg\" alt=\"Rocky Linux\" width=\"100\" title=\"Rocky Linux\"\u003e |\n| NixOS                    | ✅        | \u003cimg src=\"readme-files/nixos.svg\" alt=\"NixOS\" width=\"100\" title=\"NixOS\"\u003e |\n| LXC                      | ✅        | \u003cimg src=\"readme-files/LXC.svg\" alt=\"LXC\" width=\"64\" title=\"LXC\"\u003e |\n| Podman                   | ✅        | \u003cimg src=\"readme-files/podman.svg\" alt=\"Podman\" width=\"64\" title=\"Podman\"\u003e |\n| Windows 9x†              | ✅        | \u003cimg src=\"readme-files/windows-9x.svg\" alt=\"Windows 9x\" width=\"64\" title=\"Windows 9x\"\u003e |\n\n\u003e[!NOTE]\n\u003eRun `bbx` (or `bbx install` on Windows) to ensure you have the latest version (v13+) with all fixes and features.\n\n\\*Tails is not supported because Chrome cannot be installed.\n\n\n†Windows 9x clients are supported via the `bbx win9x-run` command which outputs the login link for legacy clients (IE 5, IE 6, Netscape). Supported client OSes: Windows 95, 98, 2000, NT. The server still needs to run on a modern system. Modern clients can use the legacy endpoint too, but the experience is understandably retro.\n\n\u003cp align=center\u003e\n  \u003cimg src=\"readme-files/browserbox-running-in-windows-98-ie-5.jpg\" alt=\"BrowserBox Legacy Client Running in IE 5 in Windows 98\" title=\"BrowserBox Legacy Client Running in IE 5 in Windows 98\" width=\"800\"\u003e\n\u003c/p\u003e\n\n---\n\n## 10. Install\n\n### Linux \u0026 macOS\n\n```bash\ncurl -fsSL https://browserbox.io/install.sh | bash\n```\n\n### Windows\n\n```powershell\nirm https://browserbox.io/install.ps1 | iex\n```\n\nFor non-interactive full installs, set `BBX_INSTALL_HOSTNAME` and `BBX_INSTALL_EMAIL`. Legacy install aliases `BBX_HOSTNAME`, `BBX_EMAIL`, and `EMAIL` remain supported for compatibility.\n\n### Via npm\n\n```bash\nnpm i -g @browserbox/browserbox\n```\n\n---\n\n## 11. Quick Start\n\n```bash\nbbx install\nbbx certify YOUR_PRODUCT_KEY\nbbx setup\nbbx run\n```\n\n---\n\n## 12. Documentation\n\n- [Customer Guide (PDF)](./docs/BrowserBox_Customer_Guide_v16.6.8.pdf)\n\n---\n\n## 13. GitHub Actions\n\nLaunch BrowserBox directly on a GitHub Actions runner with [BrowserBox/browserbox-action](https://github.com/BrowserBox/browserbox-action).\n\n- Supports `tunnel: none`, `cloudflare`, and `tor`\n- Defaults to a minimal runner footprint with `BBX_MINIMAL_MODE=true`\n- Disables update checks during runner launches with `BBX_NO_UPDATE=true`\n- Requires a BrowserBox license key from [browserbox.io](https://browserbox.io)\n\n```yaml\njobs:\n  browserbox:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Launch BrowserBox\n        id: browserbox\n        uses: BrowserBox/browserbox-action@v1\n        with:\n          license-key: ${{ secrets.BROWSERBOX_LICENSE_KEY }}\n          tunnel: cloudflare\n\n      - name: Print login link\n        run: echo \"${{ steps.browserbox.outputs.login-link }}\"\n```\n\n---\n\n## 14. Cloud API\n\nCreate on-demand ephemeral browser sessions without self-hosting. Purchase minute packs and manage sessions via REST.\n\n```bash\ncurl -X POST https://win9-5.com/api/v1/sessions \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"minutes\": 15}'\n```\n\nFull API documentation: [win9-5.com/api](https://win9-5.com/api/)\n\n---\n\n## 15. Embed BrowserBox\n\n```html\n\u003cscript src=\"https://win9-5.com/browserbox-webview.js\" type=\"module\"\u003e\u003c/script\u003e\n\u003cbrowserbox-webview\n  login-link=\"https://your-instance.com/login/abc123\"\n  width=\"1024\"\n  height=\"768\"\u003e\n\u003c/browserbox-webview\u003e\n```\n\nThe `\u003cbrowserbox-webview\u003e` element provides a session-host API with namespaced surfaces for tabs, pages, capture, augmentation, selection, and policy-gated capability control.\n\n### Install via npm\n\nThe embedding element is also published as [`@browserbox/webview-element`](https://www.npmjs.com/package/@browserbox/webview-element) for use in bundled apps:\n\n```bash\nnpm i @browserbox/webview-element\n```\n\n```js\nimport '@browserbox/webview-element';\n```\n\n---\n\n## 16. Advanced Usage\n\n- **Secure document viewing** — open PDFs and sensitive files in the remote browser without ever downloading them to the client device (Linux only)\n- **Remote DevTools** — right-click in any BrowserBox session to access full Chrome DevTools running in the isolated environment\n- **Tor and SSH tunneling** — `bbx tor-run` for anonymous onion-routed access; SSH port forwarding for private, low-latency internal routing\n\n---\n\n## 17. Flipbook Recording\n\nBrowserBox can record a browsing session as a **flipbook** — a self-contained static site of sequential JPEG frames with an interactive JavaScript viewer. Recordings are produced directly from the internal screencast pipeline with negligible overhead.\n\n### Quick Start\n\n```bash\n# Enable recording during setup\nbbx setup --flipbook-record ~/my-recording --flipbook-description \"Demo walkthrough\"\n\n# Run BrowserBox normally\nbbx run\n\n# Stop — frames are compiled into a flipbook site and optionally deployed\nbbx stop\n```\n\n### How It Works\n\n1. `bbx setup --flipbook-record \u003cdir\u003e` enables recording by writing `BBX_FLIPBOOK_DIR` to the BrowserBox config.\n2. At runtime, each screencast frame is captured as a JPEG + JSON metadata pair — zero overhead when recording is off (single boolean check per frame).\n3. On `bbx stop`, the built-in `browserbox flipbook-generate` command compiles the raw frames into a complete flipbook static site.\n4. If [Cloudflare Wrangler](https://developers.cloudflare.com/workers/wrangler/) is available, the site is deployed to Cloudflare Pages automatically.\n\n### Output\n\nEach recording produces a timestamped directory:\n\n```\n~/my-recording/\n  2026-04-14T02-25-00-000Z--2026-04-14T02-30-00-000Z/\n    site/\n      index.html        # self-contained viewer\n      manifest.json     # flipbook v1 manifest\n      pages/            # sequential JPEG frames (000000.jpg, 000001.jpg, ...)\n      assets/           # viewer.css, viewer.js, sw.js\n      meta/             # provenance.json with full per-frame metadata\n```\n\nMultiple runs to the same directory produce separate timestamped subdirectories — each is a standalone flipbook site that can be served with any static file server or deployed to any hosting platform.\n\n### Options\n\n| Flag | Description |\n|------|-------------|\n| `--flipbook-record \u003cdir\u003e` | Enable recording. Compiled flipbook sites are written here. |\n| `--flipbook-description \u003ctext\u003e` | Optional description embedded in the manifest and provenance metadata. |\n\n---\n\n## 18. License Compliance \u0026 Privacy\n\nBrowserBox requires a valid license for all deployments — commercial, non-commercial, and evaluation. Usage data is collected solely for license compliance and operational purposes; it is never sold, never shared with third parties for marketing, and never used to profile users.\n\n\u003e[!IMPORTANT]\n\u003eA valid license unlocks all features, ensures ongoing support, and guarantees a secure, compliant solution.\n\n---\n\n## 19. FAQ\n\n**Q: Can I get an evaluation license?**\nYes. Apply for a free 7-day trial at [browserbox.io](https://browserbox.io). No credit card required to evaluate.\n\n**Q: Why is a license required?**\nBrowserBox is commercial software. A license funds continued development, security research, and support. It also gives you a legitimate, supportable deployment — not a fork of old code that diverged 1,000+ commits ago.\n\n**Q: Do you offer perpetual licenses?**\nCurrent licensing is subscription-based. Enterprise arrangements, including perpetual options, are available — contact [sales@dosaygo.com](mailto:sales@dosaygo.com).\n\n**Q: How does BrowserBox compare to other RBI solutions?**\nMost RBI products are cloud-only, expensive at scale, or require proprietary endpoint agents. BrowserBox runs on your own infrastructure (or ours via Cloud API), works with any client browser, and gives you genuine control over the deployment. It's also the only RBI platform with a Windows 98½ demo, for what that's worth.\n\n**Q: What do I receive when I purchase?**\nA product key that activates `bbx`, access to all current platform binaries, documentation, and support channels. Enterprise customers above a threshold ACV can request source access for due diligence.\n\n**Q: How can I get volume discounts?**\nContact [sales@dosaygo.com](mailto:sales@dosaygo.com) for volume pricing, multi-year agreements, and enterprise terms.\n\n**Q: I may have used BrowserBox without a license. How do I become compliant?**\nReach out to [sales@dosaygo.com](mailto:sales@dosaygo.com). We handle compliance situations directly and without unnecessary drama — the goal is to get you licensed and supported, not to make things difficult.\n\n---\n\n## 20. Licensing\n\nBrowserBox is a commercial product. All usage requires a valid license.\n\n- **Commercial:** Starts at $119/user/year. [Purchase](https://dosaygo.com/commerce)\n- **Non-Commercial:** $49/user/year (non-profits, government). [Purchase](https://dosaygo.com/noncommercial)\n- **Evaluation:** [Apply for a 7-day trial](https://browserbox.io)\n- **Enterprise / Source Access:** [sales@dosaygo.com](mailto:sales@dosaygo.com)\n\n---\n\n## 21. Support\n\n- **API \u0026 Technical:** [api@browserbox.io](mailto:api@browserbox.io)\n- **General:** [support@dosaygo.com](mailto:support@dosaygo.com)\n- **Sales \u0026 Licensing:** [sales@dosaygo.com](mailto:sales@dosaygo.com)\n\n---\n\n## 22. About DOSAYGO\n\nDOSAYGO — do, say, go — those are three of the most universal human verbs, after \"to be\" (which no company has any business telling you what to do with). We're a small team building software that respects the people using it. Our products are BrowserBox (remote browser isolation) and DiskerNet (offline web archives). We don't do buzzwords. We ship things that work. Find us at [dosaygo.com](https://dosaygo.com).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReady to get started?\u003c/strong\u003e\u003cbr\u003e\n  \u003ca href=\"https://dosaygo.com/commerce\"\u003eCommercial License\u003c/a\u003e · \u003ca href=\"https://dosaygo.com/noncommercial\"\u003eNon-Commercial License\u003c/a\u003e · \u003ca href=\"mailto:sales@dosaygo.com?subject=Demo\"\u003eRequest a Demo\u003c/a\u003e\n\u003c/p\u003e\n\nBrowserBox\u0026trade; is \u0026copy; 2018-2026 DOSAYGO Corporation USA. All rights reserved.\n\n[dosaygo.com](https://dosaygo.com) | [browserbox.io](https://browserbox.io) | [CloudTabs](https://browse.cloudtabs.net)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbox%2Fbrowserbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserbox%2Fbrowserbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbox%2Fbrowserbox/lists"}