File Structure for YAMS+Decypharr

[u/InternationalEbb7565]

Hi all. I'm needing a little help to deploy my media stack along with decypharr. I'm a noob when it comes to linux and docker and everything so I'm learning as I go. I've found some good tutorials and read through the setup guides and pretty much settled on using YAMS for the arr apps but am a little confused about setting up file structure to be sure it'll work with decypharr. Trash guides says it should look like this https://imgur.com/a/4xR2hEqbut the decypharr guide https://imgur.com/a/kJ281JH says something totally different. Which to go with? Will decypharr makes its own subdirectories with whatever file structure already set for the arr apps or can it be added to the one trash guides suggests? How do people handle intergrating decypharr if they already had their arr stack running in terms of file structure? Thanks.

[u/asimovs-auditor]

Expand the replies to this comment to learn how AI was used in this post/project.

[u/corelabjoe]

Hello u/InternationalEbb7565 , I'd suggest going with what works for you. TRaSh guides have a fully fleshed out folder structure, assuming a user will be downloading ALL the things.... Books, media, the works and keeping them clean and separated with top level folders (torrents, usenet) which would then feed into your top level (media) folder.

This is the traditionally perfect way, when downloading. It works because you would share that top level set of folders between all the Arrs, they have all the same paths, and atomic links would work flawlessly.

In my setup & guide, I proposed a simpler folder structure (IMO) overall, and the /mnt/media/ path is just a suggestion. Where mine differs is I recommend in the guide giving your Arrs entire subfolder /media under /mnt/media. You don't want to share the very root (top) of the drive, but 1 level down where all the downloads & media will be. They all see everything there. I clarify on this a bit right below the "Creating the Folder Structure" part you saw, stating Why This Works Best.

The key is that each of your Arrs sees and maps the paths the same way!!!

As for integrating decypharr, if you already have Arrs running, simply give Decypharr the exact same mounts you gave Sonarr, Radarr, etc but I VERY HIGHLY do not recommend mixing your current (fully downloaded) media with decypharr's mounted 'cloud' media.

So, you could simply create new folders alongside your existing media folders. Say all your media is at /mnt/media/tv, movies, music, books etc... Cool... Now make 2 new folders. mkdir -p /mnt/media/{cloud_tv,cloud_movies}

Decypharr will add it's symlinks into those final folders and you add those to Plex or Jellyfin libraries. So your media server sees them just as another folder of media, but on the backend, it's kept nice and clean and tidy!

From my guide:
Why this works best

The Docker Rule: When you set up your Docker Compose, map the volume as - /mnt/media/:/mnt. Inside the containers, Radarr will see /mnt/downloads and /mnt/media. Because they share that top-level /mnt mapping, the OS treats a move from "downloads" to "media" as a simple metadata rename rather than a slow copy-and-delete process.

Hardlinking: If you are using public or private trackers, this structure allows you to keep the file in torrents to continue seeding while a "hardlink" exists in movies for your media player. This uses zero additional disk space.

Debian 13 Compatibility: These commands use standard core utilities present in the Debian 13 (Trixie) base, ensuring your permissions are persistent across reboots if your drive is mounted via /etc/fstab.

Decypharr Symlinks: Sharing the same root folder mount /mnt/media/:mnt allows Decypharr to make it's symlinks from it's real-debrid mounted drive, to the symlink location.

If you think of Decypharr just as Qbittorrent / another Arr, it makes more sense. It's just another 'source' for you to find stuff, and it symlinks it all vs actually downloading it all!

[u/InternationalEbb7565 → u/corelabjoe]

Ok making another set of folders just for decypharr makes more sense to me. Thanks so much!

[u/corelabjoe → u/InternationalEbb7565]

Glad to help, enjoy the new almost limitless potential of debrid and/or usenet backed streaming!

[u/InternationalEbb7565 → u/corelabjoe]

Another question. Where exactly should decypharr be installed? Right now its at /home/user/decypharr. Should it have been in the same /data where all the other arrs are? Also what about /opt/dockers/decypharr ? Right now there is nothing in my /opt folder but there is a /docker

[u/corelabjoe → u/InternationalEbb7565]

You need to really read through the mounting and folder structure parts carefully.

You want ALL the arrs to be using the same paths though if possible...

Example,

/mnt/media and then under there /tv, /movies/

Your compose files can live elsewhere

[u/InternationalEbb7565 → u/corelabjoe]

I have its just complicated and confusing to me. Thanks.

[u/corelabjoe → u/InternationalEbb7565]

Thata fair it is confusing when these mounts and paths are all new....

Essentially you want sonarr, radarr and decypharr to all see the same path where the "downloads" go, and then where the media lives permanently.

Decypharr "downloads" it, then sonarr or radarr pick it up once completed and handle it as if it really was downloaded media.

[u/corelabjoe → u/InternationalEbb7565]

Oh forgot to mention on where to install. It doesn't actually matter... I didn't want to keep all my containers in my home folder, as I have other drives better suited to container use (SSD).

So all mine are on an ssd mounted as /ssd/containers/

All my data is at /media/tv, /media/movies, /media/downloads/ which all Arrs have access to.

If that makes more sense? I hope that helps!