Skip to content

Self-Hosting

Already signed up for Browsertrix?

This guide is for developers and users who are self-hosting Browsertrix. If you've registered through webrecorder.net, you may be looking for the user guide.

Security vulnerability in versions of Browsertrix prior to v1.22.8

Versions of Browsertrix >=v1.15.0 and <v1.22.8 are vulnerable to a security issue that allows users with crawler permissions to access all data on the Browsertrix instance. If you are running an older version, upgrade to v1.22.8 or later to mitigate this issue, or contact us for assistance if you are unable to upgrade.

We also recommend upgrading Browsertrix Crawler to v1.13.0 or later if your instance is pinned to an older version.

Learn more about this security vulnerability and how to upgrade in the security advisory.

Browsertrix is designed to be a cloud-native application running in Kubernetes.

However, it is perfectly reasonable to deploy Browsertrix locally using one of the many available local Kubernetes options.

The main requirements for Browsertrix are:

  • A Kubernetes Cluster
  • Helm 3 (package manager for Kubernetes)

We have prepared a Local Deployment Guide which covers several options for testing Browsertrix locally on a single machine, as well as a Production (Self-Hosted and Cloud) Deployment guide to help with setting up Browsertrix in different production scenarios. Information about configuring storage, crawler channels, and other details in local or production deployments is in the Customizing Browsertrix Deployment Guide. Information about configuring proxies to use with Browsertrix can be found in the Configuring Proxies guide.

Details on managing org export and import for existing clusters can be found in the Org Import & Export guide.