Modules et mode sans échec

Désactivez les modules dont vous ne vous servez pas, démarrez en mode sans échec quand quelque chose casse, et redémarrez HolyArrs depuis le navigateur.

Activer ou désactiver un module

HolyArrs a 5 modules : Movies (films), TV shows (séries), Music (musique), Subtitles (sous-titres) et Requests (Demandes). Vous les choisissez une première fois dans l’assistant de premier lancement.

1. Ouvrez Settings > Parts (Paramètres > Modules).
2. Appuyez sur Turn on (activer) ou Turn off (désactiver) à côté d’un module. Vous devriez voir ses entrées de menu apparaître ou disparaître.

Rien n’est supprimé. Réactivez un module et il reprend là où il s’était arrêté.

Démarrer en mode sans échec

Le mode sans échec ne démarre que l’essentiel, pour les cas où quelque chose empêche HolyArrs de démarrer ou de fonctionner. Vous pouvez vous connecter, consulter votre bibliothèque, modifier les paramètres et faire ou restaurer une sauvegarde. Les recherches, les ajouts, les rafraîchissements, les téléchargements et les imports attendent le prochain démarrage normal.

1. Ouvrez Settings > Danger zone (Paramètres > Zone de danger).
2. Appuyez sur Restart in safe mode (redémarrer en mode sans échec). Vous devriez voir un bandeau sur chaque page.
3. Réglez le problème, puis appuyez sur Restart HolyArrs (redémarrer HolyArrs). Le démarrage suivant est normal.

Si vous n’arrivez pas à ouvrir la page, définissez HOLYARRS_SAFE_MODE=1 dans Compose ou démarrez avec -safe-mode. Enlevez-le une fois le problème réglé : les deux gardent chaque démarrage en mode sans échec.

Options

Ce qui s’arrête quand un module est désactivé

Module	S’arrête	Continue
Movies	Les pages et les entrées de menu des films, les ajouts, les recherches, les rafraîchissements	Les téléchargements déjà dans votre client de téléchargement restent suivis. Les fichiers restent.
TV shows	Les pages des séries, les ajouts, les recherches, les recherches de saisons, les rafraîchissements	Comme pour Movies.
Music	Les pages des artistes et des albums, les paramètres de musique, les rafraîchissements d’artistes, les recherches d’albums	Comme pour Movies.
Subtitles	Les paramètres de sous-titres, la page des sous-titres manquants, les recherches et les vérifications	Les fichiers de sous-titres à côté de vos vidéos restent.
Requests	Les pages des demandes et la possibilité de demander des titres	Les demandes existantes restent et reviennent quand il est réactivé.

Toujours actifs : la connexion et les comptes, les dossiers de bibliothèque, les sources, les clients de téléchargement et les téléchargements, les alertes, l’historique, les sauvegardes, les contrôles de santé, les paramètres et l’API.

• Subtitles a besoin de Movies ou de TV shows. Requests a besoin de Movies, de TV shows ou de Music. HolyArrs refuse un changement qui casse cette règle et dit quoi changer d’abord.
• Une tâche en file d’attente pour un module désactivé attend, et s’exécute dès que le module est activé.
• Désactiver un module n’économise pas de mémoire. Tout tourne dans un seul programme.

Redémarrer, mettre en pause et arrêter

Settings > Danger zone (propriétaire et administrateurs) propose Restart HolyArrs, Restart in safe mode et Shut down (arrêter), ainsi que Pause (mettre en pause), Resume (reprendre) et Restart (redémarrer) pour chaque tâche de fond, comme les sauvegardes ou la synchronisation des téléchargements.

• Les commandes qui arrêtent quelque chose vous demandent de confirmer dans les 60 s.
• Chaque commande utilisée est inscrite dans l’historique avec votre nom.
• Il faut une connexion par mot de passe. Une connexion sans mot de passe depuis votre réseau local est refusée.

Le redémarrage arrête HolyArrs proprement et laisse Docker le relancer, donc définissez restart: unless-stopped.

Politique de redémarrage	Redémarrage	Arrêt
unless-stopped ou always	Revient	Revient aussi
on-failure	Revient	Reste arrêté
no	Reste arrêté	Reste arrêté

Si ça ne fonctionne pas

Symptôme	Cause	Solution
HolyArrs ne peut pas désactiver un module	Un autre module en a besoin	Désactivez d’abord cet autre module, comme le dit le message.
Le redémarrage a arrêté HolyArrs pour de bon	La politique de redémarrage est no	Démarrez le conteneur et définissez restart: unless-stopped.
Les commandes sont refusées	Connexion locale sans mot de passe, ou la clé n’a pas control	Connectez-vous avec votre mot de passe.
Une tâche reste en échec	Elle a besoin de vous	Lisez sa raison sur /health, réglez le problème, puis appuyez sur Restart pour cette tâche.

Autres solutions : Dépannage.

Pour les experts

États de santé

/health, Settings > Parts et GET /api/v1/health/states listent chaque tâche de fond, chaque module et chaque application liée, avec un état et une raison.

État	Signification
off	Désactivé, en pause, ou non démarré en mode sans échec.
starting	En cours de démarrage, ou pas encore contrôlé.
running	Fonctionne.
retrying	A échoué ; HolyArrs réessaie, en attendant plus longtemps à chaque fois.
failed	A planté, est bloqué ou a besoin de vous. La raison dit quoi faire.

Une tâche qui a planté affiche failed, puis retrying, puis redémarre. Pendant ce temps, la connexion, la bibliothèque et les sauvegardes continuent de fonctionner. Une tâche bloquée se débloque avec un redémarrage complet.

Mémoire et mode mémoire réduite

HolyArrs vise à rester sous 384 Mio, ce qui tient dans une limite de conteneur de 500 Mo. Pour fixer votre propre cible, réglez GOMEMLIMIT à environ 80 % de la mémoire du conteneur.

Le mode mémoire réduite garde moins de choses en mémoire et lit davantage dans la base de données. Certaines pages mettent un instant de plus, et les travaux de fond comme la copie du catalogue musical tournent moins souvent.

Paramètre	Effet
(par défaut, Linux)	S’active tout seul à environ 2,5 Gio de mémoire ou moins.
HOLYARRS_LOW_MEMORY=1	Toujours activé.
HOLYARRS_LOW_MEMORY=0	Toujours désactivé.

La première ligne du journal dit s’il est activé et pourquoi.

Portées des clés API

Créez une clé dans Settings > API > API keys (Paramètres > API > Clés API) et envoyez-la dans l’en-tête X-Api-Key.

Portée	Donne accès à
read	Bibliothèque, tâches, téléchargements, historique, santé, paramètres. Secrets masqués.
health_read	Les états de santé seulement. Pour les outils de surveillance.
write	Tous les changements, sauf les routes d’administration et les commandes.
admin	Personnes, invitations, limites de demandes, clés API, mot de passe et deux facteurs, paramètres de connexion, sauvegardes.
control	Les commandes de cette page. Seuls le propriétaire et les administrateurs peuvent l’accorder.
all	read, write et admin. Pas control.

Une clé ne peut jamais faire plus que la personne qui l’a créée. Les portées ne peuvent pas être modifiées ensuite ; créez une nouvelle clé. Toutes les routes et leur portée : /api/v1/openapi.json.

Voir aussi

• Contrôles de santé
• Sauvegardes
• Routes de l’API