initial byparr commit

nodes/heimdall/byparr/README.md

@@ -0,0 +1,101 @@
+# Byparr - Cloudflare & Anti-Bot Bypass
+
+Byparr is a self-hosted service that helps bypass anti-bot challenges and Cloudflare protection, making it easier for your *arr stack (Prowlarr, Radarr, Sonarr) to access indexers and trackers.
+
+## Service Information
+
+- **Image**: `ghcr.io/thephaseless/byparr:latest`
+- **Port**: 8191
+- **API Docs**: http://localhost:8191/docs
+
+## Configuration
+
+### Basic Setup
+
+The service is configured with default settings and exposed on port 8191. It's connected to the heimdall_core_homelab network for access by other services.
+
+### Environment Variables
+
+- `HOST`: Bind address (default: 0.0.0.0)
+- `PORT`: Service port (default: 8191)
+- `PROXY_SERVER`: Optional proxy in format `protocol://host:port`
+- `PROXY_USERNAME`: Optional proxy username
+- `PROXY_PASSWORD`: Optional proxy password
+
+## Integration with *arr Apps
+
+To use Byparr with Prowlarr, Radarr, Sonarr, etc.:
+
+1. In the *arr app, go to Settings → Indexers
+2. When adding/editing an indexer that requires Cloudflare bypass:
+   - Look for "FlareSolverr" or similar bypass options
+   - Set the FlareSolverr URL to: `http://byparr:8191`
+3. Save and test the indexer
+
+### Prowlarr Configuration
+
+1. Settings → Indexers → Add Indexer
+2. Select an indexer (e.g., 1337x, EZTV, etc.)
+3. In the indexer settings:
+   - Enable "Use FlareSolverr"
+   - FlareSolverr URL: `http://byparr:8191`
+
+### Testing
+
+Visit http://heimdall-ip:8191/docs to access the API documentation and test the service.
+
+## Deployment
+
+```bash
+cd /path/to/homelab/nodes/heimdall/byparr
+docker compose up -d
+```
+
+## Monitoring
+
+Check logs:
+```bash
+docker compose logs -f byparr
+```
+
+Check status:
+```bash
+docker compose ps
+```
+
+## Troubleshooting
+
+### Service Not Working
+
+1. Check if the container is running:
+   ```bash
+   docker compose ps
+   ```
+
+2. View logs for errors:
+   ```bash
+   docker compose logs byparr
+   ```
+
+3. Test the API directly:
+   ```bash
+   curl http://localhost:8191/docs
+   ```
+
+### *arr Apps Can't Connect
+
+- Ensure Byparr and the *arr apps are on the same Docker network (heimdall_core_homelab)
+- Use `http://byparr:8191` (container name) not `localhost:8191`
+- Check if the FlareSolverr option is enabled in the indexer settings
+
+### Challenges Still Not Bypassed
+
+- This tool increases chances but doesn't guarantee bypass
+- Some sites may require additional network-level traffic validation
+- Consider configuring a proxy if available (see environment variables)
+
+## Links
+
+- [GitHub Repository](https://github.com/ThePhaseless/Byparr)
+- [Docker Image](https://ghcr.io/thephaseless/byparr)
+- [API Documentation](http://localhost:8191/docs)

nodes/heimdall/byparr/compose.yaml

@@ -0,0 +1,21 @@
+services:
+  byparr:
+    image: ghcr.io/thephaseless/byparr:latest
+    container_name: byparr
+    restart: unless-stopped
+    init: true
+    ports:
+      - "8191:8191"
+    environment:
+      - HOST=0.0.0.0
+      - PORT=8191
+      # Optional proxy settings (uncomment and configure if needed)
+      # - PROXY_SERVER=protocol://host:port
+      # - PROXY_USERNAME=username
+      # - PROXY_PASSWORD=password
+    networks:
+      - proxy-net
+
+networks:
+  proxy-net:
+    external: true