← All templates
application / DEPLOYMENT PRESET

Browserless

Browserless allows remote clients to connect and execute headless work, all inside of docker. It supports the standard, unforked Puppeteer and Playwright libraries, as well offering REST-based APIs for common actions like data collection, PDF generation and more.

Before you start

  • Clients must send browser-token. One concurrent browser and a bounded queue are configured.
  • Do not expose unauthenticated browsing; pages and downloads run within the restricted container.
  • Reserve at least 8 GiB free disk before pulling/unpacking this browser image. Runtime acceptance is pending; the development trial exhausted its small disk.

Required secrets

Configure these scoped secrets during deployment review in your Hakopod installation. Secret values stay out of the application TOML.

  • browser-token

Use this preset

  1. Open the Catalog in your own Hakopod dashboard and select Browserless.
  2. Choose the project, environment, and application name. Set the required values and secret references.
  3. Review the generated configuration, resource requests, networking, and storage plan.
  4. Deploy, then inspect readiness and logs. Configure backups for persistent data before relying on the service.

Read the upstream setup documentation ↗

View native TOML and setup notes ↗

Pinned container image

ghcr.io/browserless/chromium:latest@sha256:ae07025606e03c9b263620aaf4d09c52728f71a104ac7d471a68c23dec72c05f

The catalog pins this image for reproducibility. Review upstream updates and compatibility before changing it.