One self-hosted app for your shows, movies and music.
title: Folders description: Lay out one shared data folder so HolyArrs moves finished downloads into your Library instantly with hardlinks. level: Start sidebar: { order: 2, label: "Step 2 of 5: Folders" }
Set up your folders once so finished downloads land in your Library instantly, without a second copy.
The Install example already mounts one data folder at /data. This page shows the layout inside it and how to give your downloader the same view. Mounting /movies, /tv, /music and /downloads one by one also works, but then every import is a full copy.
Already running with separate mounts? See Move to one data folder.
The rule
Put downloads and media under one parent folder, on one disk, and mount that parent into HolyArrs and your downloader at the same path.
A hardlink is a second name for the same file. It takes no extra space and is made instantly. It only works inside one filesystem, and Docker treats every mount as its own, so separate mounts force a full copy.
/srv/data mounted as /data in HolyArrs and the downloader
├── downloads
│ ├── torrents
│ └── usenet
└── media
├── movies
├── tv
└── music
Set it up
Make the folders on the host:
mkdir -p /srv/data/downloads/{torrents,usenet} /srv/data/media/{movies,tv,music}Give your
PUIDuser write access:chown -R 1000:1000 /srv/dataMount the parent in HolyArrs:
- /srv/data:/data.Mount it the same way in your downloader:
- /srv/data:/data, and set its save folder to/data/downloads/torrentsor/data/downloads/usenet.In HolyArrs, use
/data/media/movies,/data/media/tvand/data/media/musicas Library folders during First run.You should see no No hardlink warning in Settings > Library folders.
:::caution
Separate NAS shares or datasets under /srv/data are separate filesystems. Files still copy between them. Use folders inside one share.
:::
Hardlink, move or copy
When a download finishes, HolyArrs puts each file in your Library in one of three ways:
| Download | Same mount and disk | Different mounts or disks |
|---|---|---|
| Torrent | Hardlink. The downloader keeps seeding the same file. | Copy. The torrent keeps its own file. |
| Usenet, or a file HolyArrs unpacked | Move. | Copy. HolyArrs then clears the finished job, with its files, from SABnzbd or NZBGet. |
- A hardlink or a move is instant and takes no extra space. A copy takes as long as writing the file again, and the file sits on disk twice until the downloader's copy is gone.
- Before a copy, HolyArrs checks there is room for the file. It writes the copy under a hidden
.holyarrs-name in the target folder and gives it its real name only when it is complete, so a half-written file never shows in your Library. - A copy shows in History as
by copy (hardlink not possible). - HolyArrs never moves files out of a downloader it may not change (HolyArrs can change this Downloader off, or
HOLYARRS_READONLY_DOWNLOADERS), or out of a Library folder. Those files are hardlinked, or copied.
Choices
Separate mounts
/movies, /tv, /music and /downloads as four mounts still work. Every import then copies the file, which takes longer and uses double the space until the downloader deletes its copy. That holds for Usenet downloads too, even on one disk: a file can only move instantly within one mount, so use the shared parent folder above.
Downloader in another container with other paths
If the downloader sees the folder under another name, fill in Downloader's path and HolyArrs' path on the downloader in Settings > Downloaders, such as /data/torrents and /downloads. Matching paths need no mapping.
If it does not work
| You see | Cause | Fix |
|---|---|---|
| No hardlink on a Library folder | Downloads and media are on different mounts or filesystems | Mount one parent folder, as above. Already set up? See Move to one data folder |
| Read only or Missing | The path is wrong, or PUID cannot write |
Use the path inside the container; fix ownership |
| A folder is not found | You typed the host path | Type the container path, such as /data/media/movies |
| Import says the path is not allowed | The download folder is not a known place | Set HOLYARRS_SAVE_PATH, or add it under Settings > Library folders > Extra import folders |
For experts
What the folder check tests
| Check | Fails as |
|---|---|
| Folder exists | Missing (folder is not used) |
| HolyArrs can write a test file | Read only (folder is not used) |
| Hardlink from each active downloader folder | No hardlink (warning, imports copy) |
| At least 100 MB free | Low space note |
Test files are removed after the check. Check again reruns it.
Library folder rules
- Must exist, be a folder and be a full path.
- Cannot sit inside or around another Library folder. Each path is used once.
- Rename changes only the shown name. Remove leaves every file and is refused while titles still use the folder.
- Extra import folders: one full path per line, up to 32. A whole disk such as
/orC:\is refused. Only the owner, or an admin signed in with a password, can change the list. - Manual import also allows Library folders,
HOLYARRS_SAVE_PATHand the HolyArrs side of each downloader path map. Paths with.., network share paths and links that lead outside are refused.