LibrePortal
Sponsor Get started

Decypharr

Real-Debrid Streaming

Decypharr lets Sonarr and Radarr use your Real-Debrid account as their download client. Shows and films play from Real-Debrid as if they were on your server, without filling its disk.

On this page
  1. At a glance
  2. What it's good for
  3. Before you install
  4. Signing in
  5. How to use it
  6. Works with
  7. Good to know
  8. Addresses and ports
  9. Settings
  10. In its config file
  11. Works with
  12. Privacy and security
  13. What leaves this server
  14. What LibrePortal turns off
  15. Sources
  16. Under the hood

At a glance#

What it is
Real-Debrid Streaming Media
Where it opens
Real-Debrid On its own port at http://your-server:port, or decypharr.your-domain once you have a domain
Updates
Automatic A backup is taken first, and it rolls back if the update fails
Backups
Included Part of the daily backup when that's switched on
Copies
One per server

What it's good for#

Normally a download client saves every film to your server's disk. A big collection soon fills it. Real-Debrid is a paid online service that keeps files for you. Decypharr connects to your Real-Debrid account and shows it to your server as a folder. Sonarr and Radarr hand it requests, and Jellyfin plays the results from that folder.

You need your own Real-Debrid account. LibrePortal doesn't provide one.

Real-Debrid sees what you watch

Your Real-Debrid account sees every title you add and stream, and Decypharr sends it the fingerprints (hashes) of what it asks for, to check what the service already has. If that bothers you, don't use this app.

Before you install#

You need your Real-Debrid API key. It is a long secret, found on Real-Debrid's own API token page. If you install Decypharr through Jellyfin's Stream from Real-Debrid extra, the install asks for it. You can leave it empty and add it later.

Until a key is in, Decypharr starts but mounts nothing, and says so.

Signing in#

Decypharr has no user name. Its only credential is a generated token. It is in the Login Details shown when the install finishes, and Welcome on the app's page shows it again. Use it to sign in at the Web Interface button. Sonarr and Radarr use the same token as the download client's password.

How to use it#

  1. Add your Real-Debrid key. If you didn't during the install, put it in the Real-Debrid API key setting on Decypharr's Config tab, and save. The key is kept in LibrePortal's secrets store and kept out of the logs.
  2. Check the mount. Open Decypharr with the Web Interface button. With a key in, your account is mounted at /mnt/remote inside the app.
  3. Let Sonarr and Radarr use it. Add a show or film as usual. Decypharr makes shortcuts (symlinks) to the files in a shared folder, rather than copying them, which is why nothing fills your disk.

Works with#

  • Sonarr and Radarr. With Jellyfin's Stream from Real-Debrid extra, LibrePortal adds Decypharr to each as a download client called Decypharr, with their own category names (sonarr and radarr). It switches on Automatic films & TV as well, because it needs them.
  • Jellyfin. Jellyfin gets the mounted folder too. For the Shows and Films libraries, LibrePortal switches off thumbnail, chapter-image and loudness scans, because Real-Debrid can suspend accounts that read whole files that way.
  • Bazarr. If installed, it gets the same mount.

The extra is under Tools and Add or Remove Extras on Jellyfin's page. Turning it off stops Decypharr and leaves its data.

Good to know#

  • It needs extra permissions. To make the mount, Decypharr runs with access to the FUSE device (the part of Linux that lets a program present a remote service as a folder), an extra capability and its AppArmor profile relaxed. LibrePortal sets this up and it is why Decypharr isn't a plain app.
  • The mount is rebuilt each time the apps start. It lasts until Docker restarts, so LibrePortal shares the folder again before each start of Decypharr and of the apps that read it.
  • It is limited to 1 GB of memory.
  • Updates are automatic. LibrePortal pins an exact version and offers newer ones as a step. A recovery snapshot is taken first, and the update is rolled back if Decypharr doesn't answer afterwards.
  • Backups are on by default. Real-Debrid's files are not in them, because they live with Real-Debrid.
  • Real-Debrid is not sent through the VPN extra. The Use a VPN extra covers Prowlarr's searches only, since Real-Debrid blocks most VPN addresses.

Addresses and ports#

Decypharr has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one. "Anyone" means it's reachable from wherever your server is reachable; you can make it private later.

What it isWho can reach itWith a domain
Real-Debrid Anyone decypharr.your-domain

Settings#

In its config file#

Decypharr's own settings aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.

SettingWhat it doesStarts as
Name
CFG_DECYPHARR_DISPLAY_NAME
What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_DECYPHARR_SHOW_ON_DASHBOARD
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard
Choices: true, false
false
Domain Support
CFG_DECYPHARR_DOMAIN_SUPPORT
What this app can do with more than one address one
Domain Change
CFG_DECYPHARR_DOMAIN_CHANGE
What moving it to another domain after install breaks free
Extra Addresses
CFG_DECYPHARR_ALIASES
Other addresses that serve this app in full, comma-separated Empty
Old Addresses
CFG_DECYPHARR_REDIRECTS
Other addresses that send visitors on to this app, comma-separated Empty

Works with#

These are the other apps Decypharr knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.

  • Grafana: Shows dashboards for the apps that have one. works with every app
  • Jellyfin: Play what Sonarr and Radarr find straight from Real-Debrid.
  • Prometheus: Collects metrics from the apps that can export them. works with every app
  • Uptime Kuma: Watches your apps and shows when one goes down. works with every app

Privacy and security#

Worth knowing Decypharr talks to your Real-Debrid account to add and stream what Sonarr and Radarr ask for. Real-Debrid sees the files you stream.

What leaves this server#

  • Your Real-Debrid account sees every title you add and stream
  • Torrent hashes are sent to Real-Debrid to check what it has

What LibrePortal turns off#

Nothing needed switching off.

Licence: MIT. Audited: 4 November 2026. See the privacy of every app and the Promise.

Sources#

Under the hood#

  • It runs this image: ghcr.io/sirrobot01/decypharr:v2.7.2@sha256:1fb75ea43e4f47b3f8c387178e880d79b1d73c7aab4ba6f7e1f4fa484711e450.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/sirrobot01/decypharr

Ports, settings, tools and connections on this page are read from LibrePortal v0.10.130's app catalogue each time the guide is built.

Next steps