Hardlink checker for Sonarr & Radarr

If imports take minutes and your disk fills twice as fast as it should, hardlinks are probably not working — and nothing logs an error, because Sonarr and Radarr quietly fall back to copying the whole file. This checker reads your Docker volume layout the way the kernel sees it, tells you whether imports will hardlink or silently copy, and shows you the layout that fixes it.

Start from a preset:

The volume label is any short name for the disk, pool or dataset a host folder lives on — folders with the same label are treated as the same filesystem. Results update as you type.

Verdict

The corrected layout

Whatever your current layout looks like, this is the shape that makes hardlinks and atomic moves work: one host folder, mounted at the same container path in all three apps, with downloads and media as subfolders of it.

Verify it yourself

Do not take the checker's word for it — test a file that has already been imported. Pick your platform to get the exact command, run it on a download and its imported copy, then feed the result into the interpreter.

Why imports silently copy

A hardlink is not a shortcut or a symlink — it is a second name for the exact same file on disk, so an imported episode takes up no extra space and appears instantly. The catch is that the kernel can only create a hardlink when the source and the destination are on the same filesystem and inside the same mount, as the app doing the import sees them. Sonarr and Radarr import from inside their containers, so what matters is the container's view: if downloads arrive through one bind mount and the library lives behind another, the link is refused — and rather than fail your import, the app copies the file in full and says nothing.

The one rule

Downloads and media must live under one shared mount on one filesystem in every app that touches them. The layout that guarantees it is the single /data mount recommended by TRaSH Guides' Docker folder-structure guide: one host folder mounted as /data in the download client, Sonarr and Radarr, with torrents in /data/torrents and the library in /data/media. Our *arr stack guide builds the whole stack on exactly this layout, and the Docker Compose generator will produce the full file for you.

Frequently asked questions

Why do Sonarr and Radarr copy files instead of hardlinking?

A hardlink is a second name for the same file on disk, and the kernel can only create one when the source and destination are on the same filesystem and inside the same mount, as the app sees them. If your downloads and your library reach Sonarr through separate mounts — or sit on different filesystems — the link fails and the app silently falls back to a full copy. Imports still succeed, so nothing looks broken; you just use twice the disk space and wait longer.

Both folders are on the same disk. Why does it still copy?

Because the rule is about mounts inside the container's view, not about the physical disk. Two bind mounts — say /volume1/downloads mounted as /downloads and /volume1/media mounted as /media — are separate mount boundaries in Sonarr's container even when they live on the same drive, and hardlinks cannot cross that boundary. One shared mount (the /data layout) removes the boundary.

What is the single /data layout?

It is the layout recommended by TRaSH Guides: one host folder, typically /volume1/data, mounted as /data in the download client, Sonarr and Radarr alike. Inside it, torrents live in /data/torrents and the library in /data/media, so every import stays under one mount on one filesystem and hardlinks — or atomic moves — always work.

How can I check whether hardlinks are actually working?

Compare the inode of a downloaded file with the inode of the imported copy in your library: on Linux, a NAS or Unraid, run stat -c '%i %n' on both paths — identical inode numbers, with a link count of 2 or more, mean one file with two names. Different inodes mean two separate copies. On Windows, fsutil hardlink list <file> lists every path that shares the file's data.

Related guides