Trawl

Trawl is a self-hosted web scraping engine and a FlareSolverr / Byparr drop-in replacement.

  • Development
  • Downloaders
  • Network Services
  • Tools & Utilities
Trawl is a self-hosted web scraping engine and a FlareSolverr / Byparr drop-in replacement. It bypasses JS challenges and captchas — Cloudflare, Turnstile, Interstitial, reCAPTCHA v2, hCaptcha and GeeTest — and returns cookies + user-agent over a FlareSolverr-compatible API on port 8191. Works out of the box with Prowlarr, Jackett, Sonarr, Radarr and the rest of the *arr stack. Powered by a fingerprint-patched Camoufox (Firefox) browser pool with a 4-tier escalation strategy (plain HTTP fetch -> cached browser session -> fresh Cloudflare solve -> residential proxy). Runs standalone out of the box. For faster repeat requests (bypass cookies cached in Redis), point REDIS_URL at a separate Redis container. Note: this image needs a larger shared-memory segment for the browser pool — the template sets --shm-size=1g via Extra Parameters. Do not remove it.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
100last commit 6 days ago
Popular
611,185 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
77no serious findings, 3 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 2 days ago

GitHub stars
1,185
Open issues
7
Last commit
2026-11-15
Latest release
v1.11.1
License
AGPL-3.0
Activity
declining

Checked 5 days ago - source: GitHub (germondai/trawl)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Copy .env.example to .env and check it Before starting Docker, make a real settings file from .env.example and review the values. Docker uses .env to configure the app, so skipping this step can cause wrong ports, missing credentials, or failed connections. source
  • Check the API health endpoint After Docker starts the app, open http://localhost:8191/health (a simple web check for the app's API, its main service). If it does not load, the API is not ready, so check the Docker logs before trying to connect. source
  • Install the proxy certificate if used If you use Trawl as an HTTPS proxy, install its trawl-ca.crt certificate on your browsers or client containers. Without it, secure connections may show certificate errors even though Trawl is working. source
  • Shared memory Set --shm-size=1g via Extra Parameters in your container template. Do not remove it — the browser pool needs a larger shared-memory segment. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need to create a .env file before starting Trawl with Docker?

Yes, copy .env.example to .env and review the values before starting Docker. Skipping this step can cause wrong ports, missing credentials, or failed connections.

What certificate should I install if I use Trawl as an HTTPS proxy?

Install Trawl's trawl-ca.crt certificate on your browsers or client containers. Without it, secure connections may show certificate errors even if Trawl is working.

Can Trawl be used with Prowlarr, Sonarr, or Radarr as a FlareSolverr replacement?

Yes, Trawl exposes a FlareSolverr-compatible /v1 endpoint. It works with Prowlarr and other *arr tools out of the box.

Why might the Trawl API never print ready even though Docker logs show browser launches?

Check whether the Camoufox binary is installed. The API image normally installs it during publication, but if it is missing the API can stay unready.

Answers sourced from docs.trawl.germondai.com, github.com, github.com, github.com

Community

Collected 48 days ago - public community threads