One self-hosted app for your shows, movies and music.
title: NAS, Synology and Unraid description: Run the HolyArrs container on Synology, Unraid, QNAP or TrueNAS with one shared data folder, the same as the install page. level: Start sidebar: { order: 8 }
Run HolyArrs on your NAS with the right folders, owner and restart setting. Read Install first.
Before you start
/configgoes on a local volume or pool. Never a network share.- Downloads and media go in one shared folder,
data, withdownloadsandmediainside, andmovies,tvandmusicinsidemedia. Mount it once at/data. See Folders.
Set up your NAS
:::tabs ::tab[Synology]
- In File Station, make
docker/holyarrs/config. - Make one shared folder
datawithdownloadsandmediainside, andmovies,tvandmusicinsidemedia. - In Container Manager, open Project > Create and paste the Compose file from Install.
- Set the volumes to
/volume1/docker/holyarrs/config:/configand/volume1/data:/data. - Set
PUIDandPGIDto your user, often1026and100. Check withid <user>over SSH. - Give that user read and write on
data: Control Panel > Shared Folder > Edit > Permissions. - Tick Enable auto-restart.
- Open
http://your-server:6262. You should see the first-run wizard. Add/data/media/movies,/data/media/tvand/data/media/musicas Library folders.
No Container Manager on your model? Try the experimental Synology package.
::tab[Unraid] There is no Community Applications template yet, so add the container by hand.
- In the Docker tab, add a container with the HolyArrs image.
- Map port
6262. - Map
/configto a pool path, such as/mnt/<pool>/appdata/holyarrs.<pool>is your pool's name. Not/mnt/user/appdata. - Map one data folder to
/data, using a disk or pool path such as/mnt/<pool>/data:/data. Inside it, makedownloadsandmedia, withmovies,tvandmusicinsidemedia. - Set
PUID=99,PGID=100(Unraid'snobody:users) andUMASK=022. - Turn on auto-start for the container, so it restarts on its own.
- Open
http://your-server:6262. You should see the first-run wizard. Add/data/media/movies,/data/media/tvand/data/media/musicas Library folders.
::tab[QNAP]
- Make
Container/holyarrs/configand onedatashare withdownloadsandmediainside, andmovies,tvandmusicinsidemedia. - In Container Station, open Applications > Create and paste the Compose file.
- Use
/share/Container/holyarrs/config:/configand/share/data:/data. - Set
PUIDandPGIDto the owner of thedatashare. - Set the restart policy to
unless-stopped. - Open
http://your-server:6262. You should see the first-run wizard. Add/data/media/movies,/data/media/tvand/data/media/musicas Library folders.
::tab[TrueNAS SCALE]
- Make 2 datasets:
apps/holyarrs-configanddata. Insidedata, make plain folders, not datasets:downloadsandmedia, withmovies,tvandmusicinsidemedia. - In Apps, add a custom app from YAML with the Compose file.
- Use
/mnt/<pool>/apps/holyarrs-config:/configand/mnt/<pool>/data:/data. - Set
PUIDandPGIDto the dataset's owner, often568. Give that user write access in the dataset ACL. - Set the restart policy to
unless-stopped. - Open
http://your-server:6262. You should see the first-run wizard. Add/data/media/movies,/data/media/tvand/data/media/musicas Library folders. :::
Every NAS: give the PUID user read and write on the data folder in the NAS permissions screen; HolyArrs takes care of the config folder itself. Turn on auto-restart for the container (Docker's unless-stopped policy).
Give your downloader the same mount at the same path, /data, and set its save folder inside /data/downloads. Then imports are hardlinks or moves: no extra space, done at once. See Media folders.
Choices
Separate mounts
Mounting /movies, /tv, /music and /downloads one by one works, but every import becomes a full copy. Each mount is its own filesystem inside the container, and a hardlink can't cross filesystems. Separate shares or datasets under one parent copy too. Settings > Library folders warns when HolyArrs has to copy. To switch later without importing again, see Move to one data folder.
Let your disks sleep
These jobs wake the media disks. Change how often they run on the Schedules page.
| Job | What it reads |
|---|---|
| Rescan the Library | Every Library folder. Wakes disks the most. |
| Check Library folders | Each folder's details and free space. The write and hardlink test runs only at start, on Run now and when folders change. |
| Look for missing subtitles, Look for better subtitles | The folder next to each video. |
- Put
/configand the download folder on an SSD or cache pool. - Keep 1 GB free on the disk that holds
/config. Below that you get a health warning. - On Unraid, the Cache Directories plugin keeps folder listings in memory, so scans skip the disk.
- Imports, adds and deletes touch the disk they work on, when they happen.
- Set the rescan to every 7 days or off. Files you add by hand are then found only when you press Run now on Rescan the Library.
- A seeding torrent reads its file. If it is hardlinked into your Library, that disk stays awake until seeding stops.
If it does not work
| Symptom | Cause | Fix |
|---|---|---|
| Won't start, names a FUSE path, network share or Unraid user share | /config is not on local disk (on Unraid, it points at /mnt/user) |
Move /config to a local disk or pool path, such as /mnt/<pool>/appdata/holyarrs. |
| Stays stopped after a restart or restore | Auto-restart is off | Turn it on and start the container. |
| Imports fail with a permission error | The PUID user can't write to media |
Give it read and write in the NAS permissions screen (on Synology: Control Panel > Shared Folder > Edit > Permissions). |
| Imports are copies, not hardlinks | Downloads and Library are on different mounts or disks | Mount one shared folder once, in HolyArrs and the downloader. Already set up? See Move to one data folder. |
More fixes: Troubleshooting.
For experts
Why HolyArrs refuses some config paths
HolyArrs keeps its databases in /config. Network shares and FUSE paths can corrupt them, so HolyArrs refuses to start on one and says why.
On Unraid, /mnt/user is a FUSE path. Use a pool path, or make appdata Exclusive: turn on Permit exclusive shares in Settings > Global Share Settings, then set Shares > appdata to primary storage on one pool and secondary storage to none.
A /config path on a pool that does not exist lands in memory and is lost on reboot. HolyArrs refuses that too. Avoid /mnt/user for media as well; hardlinks across it can fail.
Why auto-restart matters
Restart in the app, safe mode and a backup restore all stop HolyArrs and expect Docker to start it again. Without auto-restart it stays stopped. See Parts and safe mode.
Port and updates
- Map port
6262to your home network only. Read Security basics before opening it to anyone outside. - To update, pull the new image and recreate the container. Your data stays in
/config. See Updates.