# cloudron-flaresolverr

Proxy server to bypass Cloudflare protection. Packaged for Cloudron.

## About FlareSolverr

FlareSolverr is a proxy server to bypass Cloudflare and DDoS-GUARD protection. It's particularly useful for applications like Radarr, Sonarr, Jackett, and other automation tools that need to access websites protected by Cloudflare.

## Installation

### Prerequisites

You need to install Cloudron CLI: [Cloudron CLI Documentation](https://docs.cloudron.io/packaging/cli/)

After installation, connect the CLI to your Cloudron instance:
```bash
cloudron login <your-cloudron-domain>
```

### Build and Install

1. Build the Docker image:
   ```bash
   docker build -t yourusername/flaresolverr:1.0.0 .
   ```

2. Push the image to Docker Hub (or your preferred registry):
   ```bash
   docker push yourusername/flaresolverr:1.0.0
   ```

3. Install the app on Cloudron:
   ```bash
   cloudron install --image yourusername/flaresolverr:1.0.0
   ```

   **Note:** Make sure you're in the `cloudron-flaresolverr` directory when running this command, as Cloudron CLI needs to read the `CloudronManifest.json` file.

### Usage

After installation, FlareSolverr will be available at the URL assigned by Cloudron. The default port is 8191.

You can test the service by visiting:
- `https://your-app-url.cloudron.app/` - Shows welcome message
- `https://your-app-url.cloudron.app/health` - Health check endpoint

### Configuration

FlareSolverr can be configured using environment variables. Key environment variables include:

- `LOG_LEVEL` - Logging level (default: `info`)
- `HOST` - Host to bind to (default: `0.0.0.0`)
- `PORT` - Port to listen on (default: `8191`)
- `CAPTCHA_SOLVER` - Captcha solver service (optional)
- `PROXY_URL` - Proxy URL (optional)
- `PROXY_USERNAME` - Proxy username (optional)
- `PROXY_PASSWORD` - Proxy password (optional)

You can set these in your Cloudron app settings under "Environment Variables".

### Integration with Other Apps

To use FlareSolverr with other Cloudron apps (like Radarr, Sonarr, etc.), you'll need to:

1. Get the internal IP address of your FlareSolverr container:
   ```bash
   docker ps
   docker network inspect cloudron
   ```

2. Configure your application to use FlareSolverr:
   - URL: `http://<flaresolverr-internal-ip>:8191`
   - Or use the Cloudron internal DNS if available

### Features

- ✅ Bypass Cloudflare protection
- ✅ Bypass DDoS-GUARD protection
- ✅ Headless Chrome/Chromium support
- ✅ Automatic session management
- ✅ Health check endpoint
- ✅ Prometheus metrics support

### Troubleshooting

If you encounter issues:

1. Check the app logs:
   ```bash
   cloudron logs -f flaresolverr
   ```

2. Verify Chromium is working correctly inside the container
3. Ensure proper permissions on `/app/data` directory

### References

- [FlareSolverr GitHub Repository](https://github.com/FlareSolverr/FlareSolverr)
- [Cloudron Packaging Documentation](https://docs.cloudron.io/packaging/)
- [Cloudron Packaging Tutorial](https://docs.cloudron.io/packaging/tutorial/)

## License

MIT License - see LICENSE file for details.