# 🧠 FlareSolverr - Container 107

## Overview

FlareSolverr is a proxy server built around headless Chromium that solves Cloudflare and JavaScript challenges encountered by scrapers like Jackett. It is stateless and lightweight, serving as an essential tool in bypassing CAPTCHA or anti-bot protections for private torrent indexers.

## Service Details

- **Container ID**: 107
- **Hostname**: flaresolverr
- **IP Address**: 192.168.1.46
- **Port**: 8191
- **Access**: LAN-only or via Tailscale
- **Authentication**: None (no token or login required)
- **Exposed Domain**: ❌ Not exposed publicly
- **Dependencies**: Chromium headless, Node.js

## Hosting & Platform

- **Platform**: Native install in unprivileged Debian LXC container on Proxmox
- **Install Method**: [Community Scripts](https://community-scripts.github.io/ProxmoxVE/scripts?id=flaresolverr)
- **Features Enabled**: `keyctl=1`, `nesting=1`
- **Service Management**: systemd service (`flaresolverr.service`)
- **Runs As**: root

## Configuration

- **API URL**: `http://192.168.1.46:8191/`
- **FlareSolverr URL in Jackett**: `http://192.168.1.46:8191`
- **Protocol**: HTTP only (no SSL layer)
- **Configuration File**: None (stateless service)
- **Startup Behavior**: Starts via systemd on boot

## Integration

| Application | Integration Detail                           |
|-------------|-----------------------------------------------|
| Jackett     | Uses FlareSolverr as CAPTCHA/DDOS bypass backend |
| Radarr/Sonarr | Indirect (via Jackett integration)          |

## Backup & Recovery

- **Stateless**: No persistent configuration to back up
- **Restore Strategy**: Recreate the container or re-run the install script
- **Data**: No indexed or stored metadata

## Logs & Monitoring

- **Log Output**: Standard output via systemd journal
- **Optional**: Redirect output to `/var/log/flaresolverr.log` in service unit
- **Monitoring**: Not configured, but eligible for Prometheus exporter if extended

## Update Process

```bash
systemctl stop flaresolverr
curl -Lo /tmp/flaresolverr.tar.gz https://github.com/FlareSolverr/FlareSolverr/releases/latest/download/flaresolverr-linux-amd64.tar.gz
tar -xvzf /tmp/flaresolverr.tar.gz -C /opt/
chmod +x /opt/flaresolverr
systemctl start flaresolverr
```

## Systemd Service File

`/etc/systemd/system/flaresolverr.service`
```ini
[Unit]
Description=FlareSolverr Service
After=network.target

[Service]
ExecStart=/opt/flaresolverr
Restart=always
User=root
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
```

## Notes

- Do not expose to WAN — lacks authentication
- Restart occasionally to refresh Chromium instance
- Must be kept up-to-date to remain compatible with evolving Cloudflare and JavaScript protections