Skip to content

Zurg Stack - Real-Debrid Media Bridge

Exposes Real-Debrid library as a local mount point for Plex/Jellyfin.

Overview

  • Mount Point: /srv/dockerdata/zurg-stack/mnt/
  • Zurg Port: 9999
  • Purpose: Bridge Real-Debrid cloud torrents to local filesystem

Architecture

Real-Debrid API → Zurg (WebDAV server) → rclone (FUSE mount) → Local filesystem
                     ↓                        ↓
                  Port 9999              /mnt/torrents/

Directory Structure

/srv/dockerdata/zurg-stack/
├── docker-compose.yml
├── .env                    # RD_API_TOKEN (backup only)
├── mnt/                    # Mounted media appears here
│   ├── torrents/
│   ├── __all__/
│   └── __unplayable__/
├── zurg/
│   └── config.yml          # Zurg configuration
└── rclone/
    └── rclone.conf         # rclone WebDAV config

Configuration Files

zurg/config.yml

zurg: v1
token: YOUR_REAL_DEBRID_API_TOKEN

host: "[::]"
port: 9999

directories:
  torrents:
    group: media
    filters:
      - regex: /.*/

rclone/rclone.conf

[zurg]
type = webdav
url = http://zurg:9999/dav/
vendor = other
pacer_min_sleep = 0

Services

Start Stack

cd /srv/dockerdata/zurg-stack
docker compose up -d

Check Status

docker compose ps

View Logs

docker compose logs -f
docker compose logs zurg
docker compose logs rclone

Restart

docker compose restart
docker compose restart zurg
docker compose restart rclone

Stop Stack

docker compose down

Adding Content

  1. Go to debridmediamanager.com
  2. Log in with Real-Debrid
  3. Search for a movie/show
  4. Click a result with "Cached" badge (green)
  5. Click "Add to Library"
  6. Content appears in /srv/dockerdata/zurg-stack/mnt/torrents/ within 15-30 seconds

Troubleshooting

Empty mount folder

  • Check if Real-Debrid library has content
  • Verify token in zurg/config.yml
  • Check zurg logs: docker logs zurg

"Invalid Token" error

  • Update token in zurg/config.yml
  • Restart: docker compose restart zurg

"Connection refused" from rclone

  • Zurg may still be starting
  • Wait 10 seconds and restart: docker compose restart rclone

Mount shows I/O error

  • Stale FUSE mount from crash
  • Unmount: fusermount -u /srv/dockerdata/zurg-stack/mnt
  • Restart: docker compose restart rclone

Verify Zurg is working

curl http://localhost:9999/dav/

Integration with Plex/Jellyfin

Point your media server to:

/srv/dockerdata/zurg-stack/mnt/torrents/

For Jellyfin in Docker, mount as:

volumes:
  - /srv/dockerdata/zurg-stack/mnt:/media/zurg:ro

API Token

Get your Real-Debrid API token from: https://real-debrid.com/apitoken