Seedbox Media Library on Separate Systems
Keep a library far larger than your seedbox disk, play it from local disk, and let only one copy of each finished file leave the datacenter. A Pulsed Media seedbox downloads, seeds and runs the Sonarr and Radarr automation. A storage box holds the archive. A machine you choose (a home server, a NAS or a Minidedi) plays everything from its own disk. One scheduled rclone copy moves finished files between the systems, and nothing is mounted across the internet. Traffic between a Pulsed Media seedbox and a storage box in the same datacenter is unmetered at up to 10 Gbps: it is not counted toward your monthly cap and is not throttled, so moving files to and from the archive adds nothing to your cap.
This page is the "separate systems" layer on top of Tiered media storage with rclone and mergerfs, which builds the hot/cold library on the seedbox itself. Read that page for the mounts, the union and the mover; this one covers what changes when playback moves to another machine.
The shape of it
SEEDBOX download, seed, import (hardlink)
library folder ~/media-local ---- mover ----> STORAGE BOX
| archive, same datacenter,
| traffic not counted
| scheduled rclone copy
| (external traffic, counted once per file)
v
PLAYBACK /srv/media on the home server, NAS or Minidedi
media server plays local disk
Pick your rung
Each rung works without the ones above it. Start at the lowest one that solves a problem you actually have.
| Rung | What runs where | What you add | Stop here if |
|---|---|---|---|
| 0 | Everything on the seedbox: torrent client, Sonarr, Radarr, Jellyfin, library on the seedbox disk | Install Media Stack | The library fits your quota and you watch through Jellyfin on the seedbox |
| 1 | Seedbox plus storage box; the box is read through a cached rclone mount | One rclone mount with a VFS cache | You only want an archive you can stream |
| 2 | Seedbox plus storage box as a hot/cold library with a mover | Union and mover from Tiered media storage with rclone and mergerfs | One machine is enough and the library has outgrown its disk |
| 3 | Seedbox acquires and seeds; a home server or NAS plays from local disk | One scheduled rclone copy (this page) |
You want playback on local disk with no remote reads |
| 4 | Seedbox acquires; a Minidedi plays and transcodes, in the same datacenter | The pull from rung 3, plus a cached mount of the storage box for the archive | You need several transcoded streams or 4K HEVC |
| 5 | Any of the above, plus an independent copy | A backup job to the storage box | You would lose real work if the library disk failed |
Who runs what
| Job | Runs on | Reason |
|---|---|---|
| Torrent client, autobrr, Prowlarr | Seedbox | Full port speed, the seeding ratio, fast local disk |
| Sonarr and Radarr | Seedbox, next to the torrent client | A hardlink import needs the torrent folder and the library folder on one filesystem |
| Archive of older titles | Storage box, same datacenter | RAID5 bulk capacity; same-datacenter traffic is not counted |
| Media server | Seedbox (rungs 0 to 2), home server or NAS (rung 3), Minidedi (rung 4) | It reads the library from local disk |
| Transcoding | Only where Quick Sync or similar hardware exists; a Minidedi gives you the whole CPU and its Intel Quick Sync | Direct play needs no transcoding, so prefer it |
| Backups | Storage box | Independent of the library disk |
Sonarr and Radarr stay beside the torrent client because hardlinks only work inside one filesystem. When an import hardlinks, the seeding file and the library file are the same bytes on disk. When it has to copy, every title costs twice the space. The TRaSH Guides hardlink page explains why a mount boundary breaks it, and the tiered storage page shows how to check the link count on your own library.
Rung 3: pull the finished library
The seedbox holds the library in one folder. In the examples below that folder is ~/media-local, the hot branch from the tiered storage page; if you have no union, use your library folder, for example ~/media. Sonarr and Radarr import finished downloads into it. The playback machine copies that folder to its own disk on a schedule. The torrent folder is never copied, so partial downloads never travel.
Set up the remote on the playback machine
Install rclone on the machine that will play the library and create an SFTP remote for the seedbox. The values are the seedbox hostname, port 22 and your seedbox username; an SSH key is better than a password for a scheduled job (see Seedbox access via FTP, SSH and SFTP). A remote named pmss without a path points at your seedbox home directory.
rclone config create pmss sftp host SEEDBOX.pulsedmedia.com user USERNAME port 22 key_file ~/.ssh/id_ed25519 rclone lsd pmss:
The second command lists the top level of your seedbox home. Rclone SFTP remote mounting Seedbox covers the interactive setup, with a password or an SSH key.
The pull command
Run it once as a dry run and read the list before anything moves:
rclone copy pmss:media-local /srv/media --exclude "/torrents/**" --min-age 15m --transfers 4 --dry-run -v
/srv/media is the library folder on the playback machine. --exclude "/torrents/**" keeps the torrent folder out. --min-age 15m skips any file younger than fifteen minutes, which leaves out a file that is still being written, because its modification time is recent. A hardlink import appears whole, so it needs no such protection. --transfers 4 copies four files at once; a single stream settles around 33 to 40 MB/s however fast the link is, so parallel files are what fill the pipe, and 4 to 8 is the useful range. Remove --dry-run when the list looks right. Add --bwlimit 20M (about 20 MiB/s, an example value) if the pull must leave room for something else on the home connection.
Schedule it
On the playback machine, run the pull from cron with a lock so a slow run is never joined by the next one:
*/30 * * * * flock -n /tmp/pmss-pull.lock rclone copy pmss:media-local /srv/media --exclude "/torrents/**" --min-age 15m --transfers 4 --log-file /var/log/pmss-pull.log --log-level INFO
That line goes in root's crontab; for a normal user's crontab, pick a log path that user can write.
The job is safe to repeat. If the playback machine was off for a day, the next run copies whatever it missed. Point Jellyfin, or whichever media server you run at home, at /srv/media. It scans a local disk, so scans are fast and generate no remote reads.
What the pull does and does not do
rclone copy skips files that are identical at both ends and never deletes anything at the destination. When Sonarr or Radarr upgrades a release or renames a file, the old version stays on the playback machine until you remove it. rclone sync would mirror the seedbox exactly, but it deletes, so run it with --dry-run first if you want it.
The pull reads files and does not move them: the torrent and its hardlinked library file stay in place on the seedbox, and seeding carries on.
The pull can only copy a file that is still on the hot branch. The mover on the tiered storage page ships files to the storage box only when your quota is near full and only once they are older than the age you set (14 days in its example), so keep the pull interval far below that age.
If the playback machine was offline for longer than that, run the pull once against the union mount (~/media on the tiered storage page) instead of the hot folder. It then also reads files that have already moved to the archive, through the storage box, so do it at a quiet hour:
rclone copy pmss:media /srv/media --exclude "/torrents/**" --min-age 15m --transfers 4 -P
What it costs in traffic
Each file you pull to a machine at home is external traffic from the seedbox. The Pulsed Media Traffic Limits page states that SFTP downloads from your seedbox to your home connection are external, and external upload is what the monthly cap measures over a rolling 30 days. Every finished title therefore counts once against the cap, when it is pulled. A Minidedi in the same datacenter as the seedbox changes that: traffic between Pulsed Media servers in the same datacenter is internal and not counted. Which datacenter each of your services sits in is a question for a support ticket.
Why not mount the seedbox at home
Mounting the seedbox on the playback machine looks like it saves the second copy. Pulsed Media's Storage Boxes page advises against the equivalent for storage boxes: an SSHFS mount from outside the datacenter can disconnect under sustained load, so it is not reliable for active streaming. A remote mount also turns every playback into external upload, and it makes every library scan read remote files. The pull costs a second copy of the library on the playback machine and removes all three problems.
Rung 4: play from a Minidedi in the same datacenter
A Minidedi is a dedicated server: the whole CPU and its Intel Quick Sync graphics are yours, which is what several simultaneous transcoded streams or 4K HEVC need (Jellyfin has the settings). Plex is not allowed on shared seedboxes; it can only be used on dedicated servers such as a Minidedi, so a Minidedi is also where Plex runs if you prefer it to Jellyfin (Seedbox for Plex and Jellyfin compares the two).
Run the same pull from the seedbox to the Minidedi. When both are in the same datacenter it is internal traffic. For the older titles on the storage box, mount the box on the Minidedi with the cached mount from Tiered media storage with rclone and mergerfs: the VFS cache, read-ahead and free-space limits there are the flags that make a remote archive stream without stutter. Direct play first, transcoding only for the clients that need it.
Caching: what is cached where
| Where | What is cached | How |
|---|---|---|
| Seedbox, reading the archive | Parts of the cold files you stream | rclone VFS cache in full mode, on the seedbox's fast disk (flags on the tiered storage page)
|
| Seedbox, writing | New downloads and imports | They land on the hot branch first, so they seed at local disk speed |
| Playback machine | The whole pulled library | The files themselves sit on local disk; there is no remote read to cache |
The only rung that needs a cache tuned for streaming is the one that reads the archive through a mount. On rung 3 the playback machine never reads anything remote while you watch.
Keeping it running after a reboot
A FUSE mount on the seedbox does not come back by itself. Use the cron watchdog from the tiered storage page, and start the union only after the rclone mount is live.
Jellyfin, Sonarr, Radarr, Prowlarr and the other media apps run in tmux sessions, and a host restart ends them. The PMSS documentation describes a relaunch of the stopped apps once after a restart on newer PMSS versions. If an app is still down, use the start button in the panel's Apps tab, or run bash ~/install-media-stack.sh --start-stopped, which starts the installed apps that are not running and exits (Install Media Stack).
The pull needs no repair: the next cron run copies what it missed.
Slow? Find the branch
| What you see | Likely cause | What to do |
|---|---|---|
| One big file copies at 33 to 40 MB/s whatever the link | A single SFTP stream | Copy several files at once with --transfers 4 to 8; do not copy a library through a mount with cp or rsync
|
| A cold title stutters on first play through the cached mount | The first read comes from the storage box | Raise --vfs-read-ahead (and --buffer-size if RAM allows), as on the tiered storage page; leave --sftp-chunk-size at its default
|
| Transfers crawl at busy hours, even between two Pulsed Media servers | The disk, not the network: storage boxes sit at an Archive disk weight by design, a small share of the disk under contention, which is part of why they are cheap (Seedbox and Storage Box Disk Priority) | Move the mover and the pulls to quiet hours; more parallel transfers do not help when the disk is the limit |
| A new file is missing from the mount | The directory cache has not expired | Wait for --dir-cache-time, or send the mount process SIGHUP
|
| The pull finds nothing new | Wrong source folder, the file is younger than --min-age, or it sits in the torrent folder |
Run the pull with --dry-run -v and read the list
|
| Library scans are slow at the playback machine | The library is on a remote mount | Pull it to local disk (rung 3) |
Test each rung
Each check proves one rung.
- Hardlinks (every rung with Sonarr or Radarr, except through an rclone union, which copies instead). After the first import,
stat -c '%h %n'on the seeding file and the library file shows a link count of 2. A 1 means imports are copying. - Seeding (rung 3). After a pull, the file is still on the seedbox and the torrent is still seeding.
- Pull (rung 3). Run the dry run, then the real pull, then compare the two sides with the check command below.
--one-waychecks only that every file on the seedbox exists on the playback machine, so a file you deleted there on purpose shows as missing. - Playback (rung 3). A title imported on the seedbox appears in the media server on the playback machine after the next cron run and its library scan.
rclone check pmss:media-local /srv/media --exclude "/torrents/**" --one-way
Backups
RAID5 on the storage box survives a failed drive; it is not a backup. The pulled library on the playback machine is a second copy of what you pulled, and anything that moved to the archive before your first pull exists only there until you backfill it. For an independent copy, see 3-2-1 Backup Strategy and the guide Restic S3 Backup to Your Storage Box on PMSS, which writes to the storage box.
If your Sonarr or Radarr must run at home
This is the harder variant, and it is the reason the guide above keeps them on the seedbox. Sonarr or Radarr at home has to see the download folder from the torrent client that sits on the seedbox, so the path the client reports must be translated to a path that exists on the home machine (a remote path mapping). That needs the seedbox download folder visible at home, by mount or by a copy that finishes before the import. The import then copies the file rather than hardlinking it, and a partially transferred file can be picked up. If you need the apps at home anyway, copy finished downloads into a staging folder and move them into the folder Sonarr or Radarr watches only when the copy is complete.
See also
- Tiered media storage with rclone and mergerfs — the hot/cold library on the seedbox, with the mounts, union and mover this page builds on.
- Install Media Stack — the installer for Jellyfin, Sonarr, Radarr, Prowlarr, Autobrr and the rest of the media stack.
- Jellyfin — media server setup and hardware transcoding.
- Storage Boxes — the bulk-capacity boxes used as the archive.
- Pulsed Media Traffic Limits — what counts toward the monthly cap.
A storage box is RAID5 bulk capacity, and its traffic to a seedbox in the same datacenter stays out of your cap. See the storage box plans.