Important Note: BrowserBox Pro is available for both non-commercial and commercial use. For non-commercial use, it is free under the Polyform Non-commercial license. However, if you intend to use BrowserBox Pro for commercial applications, including customization and in customer-facing products, you are required to purchase a license. You can do so at or reach out to our sales team at to discuss a custom solution.

How to Install BrowserBox Pro - A Step-by-Step Guide

In this guide, we’ll walk you through the process of installing BrowserBox Pro, a powerful Remote Browser Isolation (RBI) system that provides enhanced security and privacy for web browsing. To make the installation easier, we’ve also created a detailed video tutorial that you can follow along with.

Video Tutorial: Installing BrowserBox Pro

Before we dive into the installation steps, we highly recommend watching our comprehensive video tutorial on YouTube: How to Install BrowserBox Pro. This video will guide you through the entire installation process and provide visual assistance for each step.

Now, let’s proceed with the installation instructions:

Initial Machine Setup

  1. As the root user, execute the following commands to set up your machine:
adduser pro  # Create a user to operate BrowserBox Pro
usermod -L pro  # Disable the password for the newly created user
addgroup sudoers  # Create a new group for sudo privileges
visudo  # Add "%sudoers ALL=(ALL) NOPASSWD:ALL" to the sudoers file
usermod -G sudoers pro  # Grant sudo privileges to the user
  1. Switch to the newly created user with sudo -u pro bash.

  2. Perform the following commands to update packages and install necessary tools (git, curl, wget):

sudo apt update && sudo apt -y upgrade
sudo apt install git curl wget

Opening TCP Port Block

To ensure smooth operation of BrowserBox Pro, you need to open a TCP port block around your main port (in this example, we’ll use port 8080).

  1. Open TCP ports 8078 through 8082 to accommodate the main browser service, audio service, and devtools service. These services run on distinct ports within the port block.

Installation Process

  1. Clone the BrowserBox Pro repository and navigate to the installation directory:
git clone
cd BrowserBoxPro
  1. Run the global installation script with your domain name:
./deploy-scripts/ <domain_name>

Make sure to replace <domain_name> with the actual domain name that points to the machine you’re installing BrowserBox Pro on.

  1. Start the main service on port 8080 and generate the login link with the following command:
setup_bbpro --port 8080
  1. Launch BrowserBox Pro by running the command:
  1. Finally, use the login link generated in the previous step to connect to the virtual browser. Open the link in a regular mobile or desktop browser.

Please note that some errors may occur during the installation process, but as long as the installation completes, these errors can typically be ignored.

To ensure optimal performance, we recommend the following system requirements:

  • Debian VPS with 2 cores, 4 GB RAM, and 100 GB SSD
  • At least a 10 Mbps internet connection
  • A public hostname with a DNS A record pointing to your VPS’s IP address

These specifications should provide satisfactory performance for a wide range of browsing tasks. If you require better performance, consider upgrading your hardware.

Remember, the location of your server plays a crucial role in performance.

We hope this guide helps you successfully install BrowserBox Pro. Remember to review the licensing requirements based on your usage, and don’t hesitate to reach out to our sales team at if you have any questions or need assistance with licensing or custom solutions.