# Browserless-v2

Browserless-v2 is a self-hosted web service that runs a headless Chromium browser in a container, letting remote clients connect over a WebSocket connection to drive and script it. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2682/browserless-v2

## Description

Browserless is a self-hosted web service that runs a headless Chromium browser in a container, letting remote clients connect over a WebSocket connection to drive and script it. It provides first-class integrations for Puppeteer, Playwright, and Selenium's WebDriver, along with handy REST (representational state transfer) APIs for common tasks such as taking screenshots and rendering PDFs. It's a good fit for developers and homelabbers who need a reliable, scriptable headless-browser backend for automation, scraping, and testing without running a browser locally.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

75/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 83 (13,900 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/browserless-v2-05fdx9i1own5ii?q=browserless-v2
- GitHub: https://github.com/browserless/browserless
- Official website: https://docs.browserless.io

## Common questions

### Which environment variables should I set before starting Browserless?

Set TOKEN to a secret value so clients can authenticate to the service. Use CONCURRENT, QUEUED, and TIMEOUT to control how many sessions run at once, how many jobs can wait, and how long a job may run.

### Why does Browserless fail to start in Docker?

It checks for the browser program files it needs when it starts. If a required file is missing, the start command fails with an error instead of bringing up the service.

### Which image should I use for Firefox or WebKit support?

Use the Firefox image or the multi image if you need Firefox or WebKit sessions. The default image is for Chromium-based work.

### How do I connect changedetection.io to Browserless as a Playwright driver?

Set PLAYWRIGHT_DRIVER_URL in the changedetection.io container to the Browserless chromium WebSocket endpoint, including the token, launch options, and blockAds setting. Use your Browserless host, port, and token.

### What port should I expose for a local Docker deployment?

Expose container port 3000 to the host. The WebSocket service is available on that port.

## Alternatives

- Geo-Peek: This website provides screenshots from 25 gepgraphical locations 12 worldover, 12 USA and 5 in europe.
- Rebrowser: The ultimate cloud browser.
- easi.run: easi.run is an open-source, self-hosted Chrome workspace for AI agents.

---
Source: Our Local Host (https://ourlocalhost.com/app/2682/browserless-v2), the self-hosted and open-source app directory.
