# Emby + Radarr/Sonarr + Real-Debrid

> [!WARNING]
>
> **Legal Responsibility**
>
> This guide demonstrates technical integration between cloud storage services and media server software. Users are solely responsible for ensuring that all content accessed, stored, or streamed through this setup is legally obtained and complies with applicable copyright laws and the terms of service of Real-Debrid and other third-party services. ElfHosted provides hosting infrastructure only and does not provide, curate, or facilitate access to copyrighted content. See our [Acceptable Use Policy](</legal/acceptable-use/>) for details.

This guide describes how to configure [Emby](</app/emby/>) with [Real-Debrid](<https://fnky.nz/support-me-when-you-buy-real-debrid>) cloud storage integration and content acquisition managed by [Radarr](</app/radarr/>) and [Sonarr](</app/sonarr/>), using symlinks for efficient library organization.

The stack described below is available in our [personal media stacks](<https://store.elfhosted.com/product-category/personal-stacks/personal-media-stacks/>), with $1, 7-day trials available on the [hobbit](<https://store.elfhosted.com/product/hobbit/>)-sized bundles.

[Get your $1, 7-day free trial!](<https://store.elfhosted.com/product/hobbit/>)

## Requirements

- [x] [Real-Debrid account](<https://fnky.nz/support-me-when-you-buy-real-debrid>) and [API token](<https://real-debrid.com/apitoken>)
- [x] An ElfHosted [personal media stack](<https://store.elfhosted.com/product-category/personal-stacks/personal-media-stacks/>) configured with Emby, Real-Debrid, and Radarr / Sonarr.

## How does it work?

Here's a diagram (*it's not as complicated as it looks!*), followed by some explanations:

```
flowchart TD

    %% User requests content
    User --> |"[1] Add to lists"|Lists
    User --> |"[2] Add requests"|SEERR[Seerr]
    User --> |"[2] Manual addition"|DOWNLOADER[Radarr / Sonarr]

    STREAMER[Emby] --> |"[6] Stream actual file"|User
    Lists --> |"[2] Import from lists"|DOWNLOADER
    Lists --> |"[1] Import from lists"|SEERR
    SEERR <--> |"[2] Add to Arrs"|DOWNLOADER
    STREAMER --> |"[6] Read file (symlink)"|SymlinkMount["/storage/symlinks/../whatever"]

    %% Prowlarr / Indexers
    DOWNLOADER <--> |"[3] Search for media"|Prowlarr
    Prowlarr --> |"[3] Search indexers"|Indexers["Your indexers"]

    DOWNLOADER <--> |"[4] Add to downloader"|SYMLINKER[Decypharr]
    DOWNLOADER --> |"[5] Import and organize"|SymlinkMount
    SYMLINKER <--> |"[4] Add torrent"|RealDebrid

    DOWNLOADER --> |"[5] Update Library"|STREAMER
    STREAMER --> |"[6] Resolve symlink (actual file)"|RDMount["/storage/realdebrid-zurg/__all__/whatever"]

    RealDebrid --> RDMount

    SYMLINKER --> |"[4] Confirm download"|RDMount
    SYMLINKER --> |"[4] Create symlink"|SymlinkMount
```

1. The user adds items to lists (*Plex Watchlist, TMDB list, MDBList, Trakt, etc.*), which feed into a request manager (*such as [Seerr](</app/seerr/>), or its predecessors [Overseerr](</app/overseerr/>) / [Jellyseerr](</app/jellyseerr/>)*) or directly into [Radarr](</app/radarr/>) / [Sonarr](</app/sonarr/>)
2. Or, the user adds items directly to [Radarr](</app/radarr/>) / [Sonarr](</app/sonarr/>), or via their request manager (*which adds them to the Arrs*)
3. Radarr / Sonarr search [Prowlarr](</app/prowlarr/>) for releases matching your size, quality, and language preferences
4. When an appropriate release is identified, Radarr / Sonarr submit it to [Decypharr](<https://store.elfhosted.com/product/decypharr/>), which adds it to your Real-Debrid library and processes the resulting file into a `completed` folder
5. Radarr / Sonarr import the file from `completed` into the intended root folder, and notify Emby of a library update
6. When you stream the media, Emby reads the symlink, resolves it to the actual file in the Real-Debrid mount, and the bytes come from Real-Debrid

## How to set it up

> [!NOTE]
>
> **Full setup guide**
>
> The step-by-step setup is available to logged-in customers. [Sign in to continue →](<https://docs-internal.elfhosted.com/guides/media/emby-realdebrid-aars/>)

## How do I get help?

1. For general use of the [individual tools](</apps/>), refer to each app's upstream site
2. For specific support re your ElfHosted configuration, see the [ElfHosted support options](</get-help/>)
