Files
cloudron-flaresolverr/README.md
bradinfluence 018956e7ce Initial FlareSolverr Cloudron package
- Add CloudronManifest.json with app metadata
- Create Dockerfile with multi-stage build
- Install Google Chrome (Chrome for Testing) since Ubuntu Noble doesn't have chromium package
- Install required Chrome dependencies (libatk, libgtk, etc.)
- Add start.sh script with Xvfb setup for headless Chrome
- Copy entire Chrome installation directory for proper resource access
- Add .gitignore and update README with installation instructions
2026-01-02 06:34:22 +00:00

3.0 KiB

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

After installation, connect the CLI to your Cloudron instance:

cloudron login <your-cloudron-domain>

Build and Install

  1. Build the Docker image:

    docker build -t yourusername/flaresolverr:1.0.0 .
    
  2. Push the image to Docker Hub (or your preferred registry):

    docker push yourusername/flaresolverr:1.0.0
    
  3. Install the app on Cloudron:

    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:

    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:

    cloudron logs -f flaresolverr
    
  2. Verify Chromium is working correctly inside the container

  3. Ensure proper permissions on /app/data directory

References

License

MIT License - see LICENSE file for details.