Deploy Browserless on Your Own Server

Browserless Web is communication between web applications without the need for a web browser.

💬 Communication

Want to deploy Browserless on your server faster? Try Senate with one-command setup, automatic HTTPS and monitoring.

Get Started

What is Browserless?

Browserless Web is communication between web applications without the need for a web browser.

Learn more

Self-Host Browserless

Follow these steps to deploy on your own server.

Install Docker

Skip this step if Docker is already installed on your server.

curl -fsSL https://get.docker.com | sh

Configure

Customize the settings below. Defaults work for most cases.

Service Name*

Domain*

General

Browserless Version*

Demo Mode*

Enable Debugger*

Deleting workspace files automatically*

Disable download behavior*

Block Ads*

Enable API GET*

Token*

Enable CORS*

Enable XVFB*

Exit on health failure*

Ignore HTTPS errors*

Ignore Default Args*

Pre-booting Chrome*

Keeping Chrome Alive*

Function Incognito Mode*

Deploy

Copy the configuration and run it on your server.

services:
  browserless:
    image: browserless/chrome:1-chrome-stable
    environment:
      CHROME_REFRESH_TIME: "3600000"
      CONNECTION_TIMEOUT: "30000"
      DEFAULT_BLOCK_ADS: "false"
      DEFAULT_IGNORE_DEFAULT_ARGS: "false"
      DEFAULT_IGNORE_HTTPS_ERRORS: "true"
      DEFAULT_USER_DATA_DIR: /user-data
      DEMO_MODE: "false"
      DISABLED_FEATURES: ""
      DISABLE_AUTO_SET_DOWNLOAD_BEHAVIOR: "false"
      ENABLE_API_GET: "true"
      ENABLE_CORS: "true"
      ENABLE_DEBUGGER: "true"
      ENABLE_XVBF: "true"
      EXIT_ON_HEALTH_FAILURE: "true"
      FUNCTION_ENABLE_INCOGNITO_MODE: "false"
      KEEP_ALIVE: "false"
      MAX_CONCURRENT_SESSIONS: "5"
      MAX_QUEUE_LENGTH: "5"
      METRICS_JSON_PATH: /metrics/metrics.json
      PREBOOT_CHROME: "false"
      TOKEN: 01a1eb1f1ffc5db71157d5ffbd36b030
      WORKSPACE_DELETE_EXPIRED: "false"
      WORKSPACE_DIR: /downloads
      WORKSPACE_EXPIRE_DAYS: "30"
    volumes:
      - browserless-workspace:/downloads
      - browserless-metrics:/metrics
      - browserless-user-data:/user-data
volumes:
  browserless-workspace: {}
  browserless-metrics: {}
  browserless-user-data: {}

Then run:

docker compose up -d

Access

Once started, access your app at http://localhost:3000

Why Self-Host Browserless?

Full Data Ownership

Your data stays on your servers. No third-party access.

No Monthly Fees

Pay only for your server. No per-seat or usage charges.

Complete Control

Customize, backup, and scale on your own terms.

Privacy & Compliance

Meet GDPR, HIPAA, or internal security requirements.

Technical Details

Docker Image

browserless/chrome:${browserless_version}

Official Docs

docs.browserless.io

Want to go faster?

Try Senate! Senate handles Docker, HTTPS, updates, and monitoring for you. Deploy any of our 300+ apps with a single command.

Install on any Linux server:

sh -c "$(curl -sSL https://get.senate.sh)"

Get Started Browse All Apps