Self-hosted, open-source personal debrid server with a Real-Debrid-compatible REST API and a Stremio addon (Jackett/Prowlarr search). Run torrent downloads on your VPS or home server, then stream via signed HTTPS links.
Not affiliated with Real-Debrid, Stremio, Jackett, or Prowlarr. See DISCLAIMER.md.
- Real-Debrid-compatible API subset for Stremio (
/user,/torrents/*,/unrestrict/link,/torrents/instantAvailability/*) - Jackett/Prowlarr search in the Stremio addon
- Progressive streaming before torrents finish downloading
- Web dashboard at
/dashboard/for torrent and disk management - Multi-user API tokens with admin dashboard (Users, Activity, Logs tabs)
- Runtime settings (retention, quota, webhooks) editable without restart
- Disk retention, quotas, and optional download rate limiting
- Optional S3-compatible object storage for completed files (docs/object-storage.md)
- Docker Compose with optional Caddy TLS, Cloudflare Tunnel, VPN sidecar, and Stremio addon profiles
- Phase 4: WebDAV library access (Infuse/Kodi/rclone), Prometheus metrics, quality filters + IINA external player in Stremio addon
- Phase 5: Sonarr/Radarr qBit API, Torrentio RD proxy, HLS transcode, seeding controls, one-line installer, release workflow
curl -fsSL https://raw.githubusercontent.com/Welfordian/DebridNest/main/scripts/install.sh | bashOr clone and run locally:
bash scripts/install.shEnvironment presets for common setups live in deploy/env/ (home, vps, minimal).
| Feature | Docs |
|---|---|
| qBittorrent Web API for Sonarr/Radarr | docs/arr-setup.md |
| Plex/Jellyfin library via WebDAV | docs/media-server.md |
| Torrentio + Real-Debrid API proxy | docs/torrentio-setup.md |
| Optional HLS transcode (ffmpeg) | docs/transcode.md |
Seeding controls (DEBRIDNEST_SEED_*) |
docs/operations.md |
| Env presets + Helm chart | deploy/env/, deploy/helm/debridnest/ |
| Release notes | CHANGELOG.md |
| Feature | Docs |
|---|---|
WebDAV at /webdav/ (read-only, Basic auth) |
docs/webdav.md |
Prometheus metrics at /metrics (DEBRIDNEST_METRICS=1) |
docs/operations.md |
| VPN sidecar (Gluetun) for torrent traffic | docs/vpn.md |
| Stremio quality filters (resolution, SDR, file size) | docs/stremio-setup.md |
| IINA external player helper | docs/stremio-setup.md |
- Docker and Docker Compose
- At least one torrent indexer added in Jackett (web UI at
http://localhost:9117after first boot) - Stremio desktop app (recommended for playback)
- Copy and configure environment:
cp .env.example .env
# Set DEBRIDNEST_API_TOKEN, DEBRIDNEST_PUBLIC_URL, JACKETT_URL, JACKETT_API_KEY- Start DebridNest + Jackett + Stremio addon:
docker compose --profile stremio up -d --build- Configure Jackett (first time only):
On first boot, jackett-setup automatically adds public indexers (1337x, knaben, limetorrents, magnetz, nyaasi, rutracker-ru, thepiratebay, therarbg, yts). Open http://localhost:9117 to add more.
Verify:
curl -s 'http://127.0.0.1:7001/diagnostics?jackettUrl=http%3A%2F%2Fjackett%3A9117' | python3 -m json.tool-
Install in Stremio:
http://127.0.0.1:7001/configure— see docs/stremio-setup.md -
Open the dashboard:
http://localhost:8080/dashboard/ -
Open any movie/show in Discover → Streams tab → pick a DebridNest stream.
See docs/operations.md for retention, quotas, and admin API.
See docs/remote-access.md for Caddy TLS and Cloudflare Tunnel setup.
See .env.example for the full list of environment variables (webhooks, seeding, transcode, VPN, qBit, etc.).
| Variable | Default | Description |
|---|---|---|
DEBRIDNEST_API_TOKEN |
(required) | Bearer token for API auth |
DEBRIDNEST_MULTI_USER |
1 |
1 = per-user tokens in SQLite; 0 = legacy single shared token |
DEBRIDNEST_PUBLIC_URL |
http://localhost:8080 |
Public URL in download/host links |
DEBRIDNEST_DOMAIN |
localhost |
Domain for Caddy --profile tls |
DEBRIDNEST_DATA_DIR |
/data |
Persistent storage root |
JACKETT_URL |
http://jackett:9117 (Docker) |
Jackett base URL for the Stremio addon |
JACKETT_API_KEY |
— | Jackett/Prowlarr API key |
CLOUDFLARE_TUNNEL_TOKEN |
— | For --profile tunnel |
DEBRIDNEST_RETENTION_DAYS |
30 |
Auto-delete completed torrents after N days |
DEBRIDNEST_DISK_QUOTA_GB |
0 |
Disk quota in GB (0 = unlimited) |
DEBRIDNEST_DOWNLOAD_RATE_LIMIT_MBPS |
0 |
Download egress cap on signed /dl/* and HLS segments |
DEBRIDNEST_WEBDAV_ENABLED |
1 |
WebDAV library access at /webdav/ |
DEBRIDNEST_WEBDAV_USER / DEBRIDNEST_WEBDAV_PASSWORD |
— | Custom WebDAV Basic auth (default: user debridnest, password = API token) |
DEBRIDNEST_METRICS |
0 |
Enable Prometheus metrics at /metrics |
PREFER_SDR |
0 |
Stremio addon: prefer SDR over HDR/DV |
MAX_RESOLUTION |
0 |
Stremio addon: max resolution (720, 1080, 2160; 0 = any) |
MAX_FILE_SIZE_GB |
0 |
Stremio addon: max torrent size in GB (0 = unlimited) |
Generate a real DEBRIDNEST_API_TOKEN before startup; copied placeholders such as change-me-to-a-long-random-string are rejected. Numeric environment variables are validated at startup, and 0 is only accepted for settings documented as disabled, unlimited, or defaulted.
See DISCLAIMER.md. You are responsible for lawful use of this software.
MIT — see LICENSE.