I maintain this and other Home Assistant add-ons in my free time: keeping up with Immich changes, HA changes, and testing on real hardware takes a lot of time (and some money).

If this add-on saves you time or makes your setup easier, you can support my work here:

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

FlareSolverr is a proxy server to bypass Cloudflare protection. It starts a proxy server that waits for user requests in an idle state using few resources. When a request arrives, it uses Puppeteer with the stealth plugin to create a headless browser (Firefox) that solves Cloudflare challenges.

Key features:

Bypasses Cloudflare protection automatically
Headless browser automation with Firefox
RESTful API for integration with other tools
Cookie extraction for subsequent requests
Support for various Cloudflare challenge types

Note: Web browsers consume significant memory. Avoid making many concurrent requests on systems with limited RAM.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.

Add my add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA)
Install this add-on.
Click the Save button to store your configuration.
Start the add-on.
Check the logs of the add-on to see if everything went well.

Configuration

Web interface can be found at http://homeassistant:8191. This addon has no configuration options - it works out of the box.

API Usage

FlareSolverr provides a REST API for integration with other applications:

Endpoint: http://homeassistant:8191/v1

Example Request:

{
  "cmd": "request.get",
  "url": "https://example.com",
  "maxTimeout": 60000
}

Integration with *arr Apps

Configure your indexers to use FlareSolverr:

Prowlarr/Jackett: Set FlareSolverr URL to http://homeassistant:8191
Sonarr/Radarr: Configure indexers to use the FlareSolverr proxy

Options

No configuration options are available - FlareSolverr works automatically with default settings.

Resource Requirements

Memory: 512MB+ recommended
CPU: Moderate usage during challenge solving
Network: Requires internet access to function

Environment variables

Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Support

Create an issue on github