NAS, Synology et Unraid

Faites tourner HolyArrs sur votre NAS avec les bons dossiers, le bon propriétaire et le bon paramètre de redémarrage. Lisez d’abord Installer.

Avant de commencer

• /config va sur un volume ou un pool local. Jamais sur un partage réseau.
• Les médias vont dans un seul dossier partagé qui contient downloads, movies, tv et music. Montez chacun d’eux, ou le dossier parent une seule fois pour les hardlinks (liens physiques). Voir Dossiers.

Configurer votre NAS

::tab[Synology]

1. Dans File Station, créez docker/holyarrs/config.
2. Créez un seul dossier partagé media qui contient downloads, movies, tv et music.
3. Dans Container Manager, ouvrez Project > Create (Projet > Créer) et collez le fichier Compose de la page Installer.
4. Réglez les volumes sur /volume1/docker/holyarrs/config:/config, puis /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music et /volume1/media/downloads:/downloads.
5. Réglez PUID et PGID sur votre utilisateur, souvent 1026 et 100. Vérifiez avec id <user> en SSH.
6. Donnez à cet utilisateur l’accès en lecture et en écriture sur media : Control Panel > Shared Folder > Edit > Permissions (Panneau de configuration > Dossier partagé > Modifier > Permissions).
7. Cochez Enable auto-restart (activer le redémarrage automatique).
8. Ouvrez http://your-server:6262. Vous devriez voir l’assistant de premier lancement. Ajoutez /movies, /tv et /music comme dossiers de bibliothèque.

::tab[Unraid]

Il n’y a pas encore de modèle Community Applications, donc ajoutez le conteneur à la main.

1. Dans l’onglet Docker, ajoutez un conteneur avec l’image HolyArrs.
2. Mappez le port 6262.
3. Mappez /config sur un chemin de pool, comme /mnt/<pool>/appdata/holyarrs. <pool> est le nom de votre pool. Pas /mnt/user/appdata.
4. Mappez vos dossiers multimédias sur /movies, /tv, /music et /downloads, avec des chemins de disque ou de pool, par exemple /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music et /mnt/<pool>/media/downloads:/downloads.
5. Réglez PUID=99, PGID=100 (le nobody:users d’Unraid) et UMASK=022.
6. Activez le démarrage automatique du conteneur, pour qu’il redémarre tout seul.
7. Ouvrez http://your-server:6262. Vous devriez voir l’assistant de premier lancement.

::tab[QNAP]

1. Créez Container/holyarrs/config et un seul partage media qui contient downloads, movies, tv et music.
2. Dans Container Station, ouvrez Applications > Create (Applications > Créer) et collez le fichier Compose.
3. Utilisez /share/Container/holyarrs/config:/config, puis /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music et /share/media/downloads:/downloads.
4. Réglez PUID et PGID sur le propriétaire du partage media.
5. Réglez la politique de redémarrage sur unless-stopped.
6. Ouvrez http://your-server:6262. Vous devriez voir l’assistant de premier lancement.

::tab[TrueNAS SCALE]

1. Créez 2 datasets : apps/holyarrs-config et media, avec les dossiers downloads, movies, tv et music dans media.
2. Dans Apps, ajoutez une application personnalisée à partir de YAML avec le fichier Compose.
3. Utilisez /mnt/<pool>/apps/holyarrs-config:/config, puis /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music et /mnt/<pool>/media/downloads:/downloads.
4. Réglez PUID et PGID sur le propriétaire du dataset, souvent 568. Donnez à cet utilisateur l’accès en écriture dans l’ACL du dataset.
5. Réglez la politique de redémarrage sur unless-stopped.
6. Ouvrez http://your-server:6262. Vous devriez voir l’assistant de premier lancement.

Sur tous les NAS : donnez à l’utilisateur PUID l’accès en lecture et en écriture sur le dossier multimédia dans l’écran des permissions du NAS ; HolyArrs s’occupe lui-même du dossier de configuration. Activez le redémarrage automatique du conteneur (la politique unless-stopped de Docker).

Pour les hardlinks, qui ne prennent pas de place en plus et se terminent tout de suite, montez le dossier multimédia unique à la place des quatre, et donnez à votre client de téléchargement le même montage au même chemin. Voir Dossiers multimédias.

Options

Montages séparés

Monter /movies, /tv, /music et /downloads un par un fonctionne, mais chaque import devient une copie complète. Chaque montage est un système de fichiers à part dans le conteneur, et un hardlink ne peut pas passer d’un système de fichiers à un autre. Des partages ou des datasets séparés sous un même parent donnent des copies aussi. Settings > Library folders (Paramètres > Dossiers de bibliothèque) vous avertit quand HolyArrs doit copier.

Laisser vos disques dormir

Ces tâches réveillent les disques multimédias. Changez leur fréquence sur la page Schedules (Planifications).

Tâche	Ce qu’elle lit
Rescan the Library (rescanner la Bibliothèque)	Tous les dossiers de bibliothèque. C’est elle qui réveille le plus les disques.
Check Library folders (contrôler les dossiers de bibliothèque)	Les détails et l’espace libre de chaque dossier. Le test d’écriture et de hardlink ne tourne qu’au démarrage, avec Run now (lancer maintenant) et quand les dossiers changent.
Look for missing subtitles (chercher les sous-titres manquants), Look for better subtitles (chercher de meilleurs sous-titres)	Le dossier à côté de chaque vidéo.

• Placez /config et le dossier de téléchargement sur un SSD ou un pool de cache.
• Gardez 1 Go libre sur le disque qui contient /config. En dessous, vous recevez un avertissement de santé.
• Sur Unraid, le plugin Cache Directories garde les listes de dossiers en mémoire, donc les scans ne touchent pas le disque.
• Les imports, les ajouts et les suppressions touchent le disque sur lequel ils travaillent, au moment où ils ont lieu.
• Réglez le rescan sur tous les 7 jours ou désactivez-le. Les fichiers que vous ajoutez à la main ne sont alors trouvés que lorsque vous appuyez sur Run now pour Rescan the Library.
• Un torrent en cours de partage lit son fichier. S’il est relié par hardlink à votre Bibliothèque, ce disque reste éveillé jusqu’à la fin du partage.

Si ça ne fonctionne pas

Symptôme	Cause	Solution
Ne démarre pas, cite un chemin FUSE, un partage réseau ou un partage utilisateur Unraid	/config n’est pas sur un disque local (sur Unraid, il pointe vers /mnt/user)	Déplacez /config vers un disque local ou un chemin de pool, comme /mnt/<pool>/appdata/holyarrs.
Reste arrêté après un redémarrage ou une restauration	Le redémarrage automatique est désactivé	Activez-le et démarrez le conteneur.
Les imports échouent avec une erreur de permission	L’utilisateur PUID ne peut pas écrire dans les médias	Donnez-lui l’accès en lecture et en écriture dans l’écran des permissions du NAS (sur Synology : Control Panel > Shared Folder > Edit > Permissions).
Les imports sont des copies, pas des hardlinks	Les téléchargements et la Bibliothèque sont sur des montages ou des disques différents	Montez un seul dossier partagé une seule fois, dans HolyArrs et dans le client de téléchargement.

Autres solutions : Dépannage.

Pour les experts

Pourquoi HolyArrs refuse certains chemins de configuration

HolyArrs garde ses bases de données dans /config. Les partages réseau et les chemins FUSE peuvent les corrompre, donc HolyArrs refuse de démarrer sur l’un d’eux et dit pourquoi.

Sur Unraid, /mnt/user est un chemin FUSE. Utilisez un chemin de pool, ou rendez appdata exclusif : activez Permit exclusive shares (autoriser les partages exclusifs) dans Settings > Global Share Settings (Paramètres > Paramètres globaux des partages), puis réglez Shares > appdata (Partages > appdata) avec le stockage principal sur un seul pool et aucun stockage secondaire.

Un chemin /config sur un pool qui n’existe pas atterrit en mémoire et est perdu au redémarrage de la machine. HolyArrs refuse ça aussi. Évitez aussi /mnt/user pour les médias ; les hardlinks peuvent y échouer.

Pourquoi le redémarrage automatique compte

Le redémarrage depuis l’application, le mode sans échec et la restauration d’une sauvegarde arrêtent tous HolyArrs et comptent sur Docker pour le relancer. Sans redémarrage automatique, il reste arrêté. Voir Modules et mode sans échec.

Port et mises à jour

• Mappez le port 6262 sur votre réseau domestique seulement. Lisez Les bases de la sécurité avant de l’ouvrir à quelqu’un de l’extérieur.
• Pour mettre à jour, récupérez la nouvelle image et recréez le conteneur. Vos données restent dans /config. Voir Mises à jour.

Voir aussi

• Dossiers
• Dossiers de bibliothèque
• Planifications