Frequently Asked Questions

General

What is Decypharr?

Decypharr is a media gateway that provides a unified interface for accessing Debrid providers (Real Debrid, All Debrid, etc.) and Usenet via Sonarr, Radarr, and other *Arr applications. It acts as a QBitTorrent/Sabnzbd-compatible download client.

Is it free?

Yes, Decypharr itself is free and open source. However, you need subscriptions to:

Debrid providers (Real Debrid, All Debrid, etc.)
Usenet providers (if using Usenet features)

How is this different from just using Debrid directly?

Decypharr adds:

Arr integration (Sonarr/Radarr compatibility)
File mounting (DFS, Rclone, WebDAV)
Automated repair for broken links
Usenet + Debrid hybrid support
Centralized management

Setup & Configuration

Where is the config file located?

Docker: /config/config.json (mapped volume)
Binary: You choose the location on first run ./decypharr --config /path/to/

Can I use environment variables instead of config.json?

Yes! All config options support environment variables using double underscore notation:

PORT=8282
DEBRIDS__0__PROVIDER=realdebrid
DEBRIDS__0__API_KEY=your_key

See Configuration Reference for all options.

How do I get my API token?

After setup, go to Settings → Auth in the web UI. Your API token is displayed once after initial setup - save it immediately.

To regenerate:

curl -X POST -H "Authorization: Bearer OLD_TOKEN" \
  http://localhost:8282/api/refresh-token

Debrid Providers

Can I use multiple Debrid providers?

Yes! Add multiple providers in config:

{
  "debrids": [
    {"provider": "realdebrid", "api_key": "..."},
    {"provider": "alldebrid", "api_key": "..."}
  ]
}

Decypharr will automatically distribute torrents across providers based on available slots.

How do I handle Debrid rate limits?

Configure per-provider rate limits:

{
  "debrids": [
    {
      "provider": "realdebrid",
      "rate_limit": "200/minute",
      "repair_rate_limit": "60/minute"
    }
  ]
}

Or add multiple API keys for rotation:

{
  "download_api_keys": ["KEY1", "KEY2", "KEY3"]
}

What happens when Debrid slots are full?

Configure minimum_free_slot to switch to backup provider:

{
  "debrids": [
    {
      "provider": "realdebrid",
      "minimum_free_slot": 5
    },
    {
      "provider": "alldebrid",
      "minimum_free_slot": 0
    }
  ]
}

If RD has <5 free slots, Decypharr uses All Debrid.

Mounting

Which mount type should I use?

Use Case	Recommended
Streaming-focused	DFS
Need write caching	Rclone
Already have Rclone setup	External Rclone
API/WebDAV only	None

DFS is recommended for most users. On Windows, DFS mounting requires WinFsp to be installed.

How do I fix “Permission Denied” on mount?

Set uid/gid to match your media server user:

id plex
# uid=1001(plex) gid=1001(plex)

{
  "mount": {
    "dfs": {
      "uid": 1001,
      "gid": 1001,
      "allow_other": true
    }
  }
}

Can I mount without FUSE?

Yes, use WebDAV:

http://decypharr:8282/webdav/

Mount as network drive in Windows/macOS/Linux. See WebDAV Guide.

Usenet

Do I need Sabnzbd or NZBGet?

No! Decypharr connects directly to NNTP servers. Just add your Usenet provider(s) in config.

Why is Usenet processing slow?

Increase connection limits:

{
  "usenet": {
    "max_connections": 20,
    "max_concurrent_nzb": 3
  }
}

And per-provider:

{
  "usenet": {
    "providers": [
      {
        "max_connections": 30
      }
    ]
  }
}

Arr Integration

Path mapping not working?

Ensure Arr and Decypharr see files at the same path.

Wrong (Docker):

decypharr:
  volumes:
    - /mnt/storage:/data
sonarr:
  volumes:
    - /mnt/storage:/media  # Different path!

Correct:

decypharr:
  volumes:
    - /mnt/storage:/mnt/storage
sonarr:
  volumes:
    - /mnt/storage:/mnt/storage  # Same path!

Downloads not importing in Arr?

Check download action is set correctly (symlink for mounts)
Verify mount path is accessible
Check Arr logs for specific error

Can I use both Debrid and Usenet in same Arr?

Yes! Add both download clients:

Decypharr (QBitTorrent) for torrents
Decypharr (Sabnzbd) for NZBs

Set different priorities in Arr.

Repair Worker

When should I enable auto-repair?

Use auto_process: true if:

You have stable providers
Want fully automated operation
Not concerned about resource usage

Use auto_process: false if:

Testing repair system
Want manual control
Concerned about API rate limits

What’s the difference between repair strategies?

per_file: Check each file independently (faster for large torrents)
per_torrent: Verify all files in torrent (ensures complete integrity)

Performance

How much disk space does caching use?

Configure disk_cache_size:

{
  "mount": {
    "dfs": {
      "disk_cache_size": "50GB"
    }
  }
}

Actual usage depends on your viewing patterns.

Streaming is buffering constantly

Increase chunk size:
```
{"dfs": {"chunk_size": "20MB"}}
```
Increase read-ahead (Usenet):
```
{"usenet": {"read_ahead": "32MB"}}
```
Check Debrid provider performance
Verify network bandwidth

Troubleshooting

WebUI won’t load

Verify Decypharr is running:

docker logs decypharr
curl http://localhost:8282/version

Check port binding
Check firewall rules

”Setup Required” loop

Delete config to restart setup:

rm /config/config.json  # Docker
# or
rm /path/to/config.json  # Binary

High CPU/Memory usage

Reduce concurrent workers:

{
  "debrids": [{"workers": 25}],
  "repair": {"workers": 1}
}

Check for repair loops (disable auto-repair temporarily)
Review logs for errors

Where are the logs?

Docker:

docker logs decypharr
docker logs -f decypharr  # Follow

Binary: stdout (redirect to file if needed)

Set log level:

{"log_level": "debug"}

Migration

Moving from MKVToolNix/Stremio/etc?

Decypharr can coexist:

Keep existing setup running
Add Decypharr as additional download client in Arrs
Set higher priority for Decypharr
Test with new downloads
Once stable, remove old client

Switching from Rclone mount to DFS?

Stop Decypharr
Change config:
```
{"mount": {"type": "dfs"}}
```
Restart
Verify mount at same path
Test playback

No need to re-download - Decypharr reuses existing Debrid torrents.