Skip to content

FlareSolverr Prowlarr Integration Guide

Keith Lewis edited this page Mar 31, 2026 · 5 revisions

Feeling appreciative? Please subscribe to my youtube channel www.youtube.com/@kltechvideos

🚀 FlareSolverr Integration Guide

This guide explains how to deploy FlareSolverr using Docker and integrate it with Prowlarr to bypass Cloudflare security challenges and captchas.

Images below.


🐳 Step 1: Install FlareSolverr via Docker

FlareSolverr acts as a proxy server to navigate Cloudflare "Waiting Room" screens. It is best run as a background container.

Option A: Docker Compose (Recommended) 🛠️

Add the following to your docker-compose.yml file:

services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    environment:
      - LOG_LEVEL=info
      - TZ=UTC # Change to your local timezone
    ports:
      - 8191:8191
    restart: unless-stopped

Option B: Docker CLI 💻

Run this command in your terminal to pull and start the container:

docker run -d \
  --name=flaresolverr \
  -p 8191:8191 \
  -e LOG_LEVEL=info \
  --restart unless-stopped \
  ghcr.io/flaresolverr/flaresolverr:latest

🛰️ Step 2: Configure FlareSolverr in Prowlarr

Once the container is running, you must link it to Prowlarr as an Indexer Proxy.

  1. Open Prowlarr and go to Settings > Indexers. (Note this is different from the primary list of torrent/usenet indexers. Different screen altogether.
  2. Click the + (Plus) button to add a new proxy.
  3. Select FlareSolverr from the list.
  4. Fill in the following details:
  • Name: FlareSolverr
  • Host: http://flaresolverr:8191 (if using Docker DNS) or http://[YOUR-SERVER-IP]:8191
  • Tags: Type flare and press Enter. 🏷️
  1. Click Test (you should see a green checkmark) and then Save.

🏷️ Step 3: Link Indexers to FlareSolverr

FlareSolverr will only be used for indexers that you specifically tag. This prevents unnecessary overhead for sites that don't use Cloudflare.

  1. In Prowlarr, go to the Indexers page.
  2. Find an indexer that frequently triggers Cloudflare blocks (e.g., 1337x or TorrentGalaxy).
  3. Click the Wrench Icon (Edit).
  4. Scroll down to the Tags field.
  5. Add the tag: flare.

Note: This must match the tag you created in Step 2 exactly.

  1. Click Save.

🔍 How to Verify It's Working

  • Logs: Check the FlareSolverr Docker logs. You should see messages like Browser checking... followed by Challenge solved! when a search is performed.
  • Prowlarr: Go to History in Prowlarr. If a search previously failed with a 403 Forbidden or Cloudflare error and now succeeds, the setup is working perfectly. ✅

Tip

If you are running multiple instances of FlareSolverr for different locations, you can use unique tags like flare-uk or flare-us to route specific indexers to specific proxies.

Images below:

Screenshot 2025-12-24 050259 Screenshot 2025-12-24 050045 Screenshot 2025-12-24 045812 Screenshot 2025-12-24 050305 Screenshot 2025-12-24 050542 Screenshot 2025-12-24 050524 Screenshot 2025-12-24 050518

Clone this wiki locally