Mises à jour

Pour débuter

HolyArrs vous prévient quand une nouvelle version est sortie et ne l’installe jamais. Vous récupérez la nouvelle image quand ça vous arrange.

Voir si une nouvelle version est sortie

Ouvrez la page Status (État) (http://your-server:6262/health).
Lisez Updates (Mises à jour). Vous devriez voir l’un de ces messages :

Message	Signification
« HolyArrs 1.2.0 is out, newer than this one. »	Mettez à jour quand vous êtes prêt
« This is the newest version. »	Rien à faire
« No HolyArrs release is published yet. »	Le flux est vide. Tout va bien
« The last check did not work: … »	Flux injoignable, souvent faute d’accès à Internet
« The update check is off: … »	Désactivée dans les paramètres

Pour vérifier tout de suite, choisissez Check now (vérifier maintenant) (ou Check again, vérifier à nouveau). Il faut la permission Change settings (modifier les paramètres).

Une version plus récente apparaît aussi comme un avertissement de santé. Une vérification qui a échoué n’apparaît que sous Updates.

Mettre à jour

Récupérez la nouvelle image et redémarrez : docker compose pull, puis docker compose up -d.
HolyArrs démarre. Si la nouvelle version change la façon dont les données sont stockées, il fait d’abord une sauvegarde, puis met les données à jour. Vous devriez voir l’application s’ouvrir sur la nouvelle version.

Revenir à l’ancienne version

HolyArrs ne peut pas changer sa propre image : vous lancez donc l’ancienne image, et HolyArrs remet les anciennes données en place.

Dans votre fichier compose (ou votre docker run), remplacez le tag de l’image par l’ancien, par exemple holyarrs/holyarrs:<older version>.
Lancez docker compose up -d.
Si la mise à jour n’a pas modifié les données, l’ancienne version démarre. C’est terminé.
Sinon, l’ancienne version affiche une page à la place de l’application. Choisissez Put back the data from before the update (remettre les données d’avant la mise à jour).
Saisissez le code à usage unique. Vous le trouvez avec docker logs <container> ; cherchez « one-time code ».
HolyArrs vérifie la sauvegarde, la met en place et s’arrête. Vous devriez voir le conteneur redémarrer sur ces données grâce à sa politique de redémarrage. S’il n’en a pas, démarrez-le vous-même.

Sans la page : docker exec <container> /holyarrs restore --pre-update, puis docker restart <container>. Sans Docker : arrêtez HolyArrs, lancez holyarrs restore --pre-update, puis démarrez-le.

Rien n’est supprimé. Les données plus récentes sont déplacées dans backups/before-restore-<time>/, vous pouvez donc annuler. Si vous revenez de plus d’une version en arrière, HolyArrs prend la sauvegarde d’avant mise à jour la plus récente que cette version sait lire.

Options

Tout se trouve dans Settings > Health checks (Paramètres > Contrôles de santé). Les trois dernières sont dans la partie avancée de la carte.

Paramètre	Par défaut	À modifier quand
Check for a newer HolyArrs (vérifier s’il existe un HolyArrs plus récent)	Activé	Vous ne voulez aucune requête vers l’extérieur
Check for updates every (vérifier les mises à jour tous les)	jour	Vous voulez moins de vérifications : 3, 7, 14 ou 30 jours
Release feed (flux des versions)	Vide (versions de HolyArrs)	Vous hébergez votre propre flux
Feed may be on the local network (le flux peut être sur le réseau local)	Désactivé	Votre flux est sur votre propre réseau
Include test versions (like 1.2.0-rc1) (inclure les versions de test, comme 1.2.0-rc1)	Désactivé	Vous voulez être prévenu des versions de test

Si ça ne fonctionne pas

Symptôme : « The last check did not work. » Cause : le serveur n’a pas accès à Internet, ou votre propre flux est sur le réseau local. Solution : vérifiez l’accès à Internet, ou activez Feed may be on the local network.

Symptôme : le flux des versions ne s’enregistre pas. Cause : l’adresse contient un nom, un mot de passe, ?query ou #fragment, ou ne commence pas par http:// ou https://. Solution : supprimez ces parties.

Symptôme : la mise à jour s’est arrêtée par manque d’espace disque. Cause : pas assez de place pour la copie et la mise à jour. Solution : libérez de l’espace là où se trouve le dossier de configuration, puis redémarrez.

Symptôme : la page de retour à l’ancienne version refuse votre code. Cause : un ancien code, ou 10 codes erronés depuis le dernier démarrage. Solution : copiez le code depuis la ligne la plus récente du journal. Après 10 essais erronés, redémarrez le conteneur et utilisez le nouveau code.

Fonctionnalités en réserve

Certaines fonctionnalités sont désactivées par défaut dans cette version. Activez-les à vos risques et périls. Tant qu’elles sont en réserve, leurs pages et leurs entrées de menu sont masquées, leurs routes d’API répondent « not found » et leurs tâches ne tournent pas. Les données que vous avez enregistrées pour elles sont conservées.

Pour en activer une, ajoutez son interrupteur à HOLYARRS_FLAGS, séparé par des virgules, et redémarrez le conteneur :

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Pour la désactiver, supprimez le nom et redémarrez. Les paramètres masqués reviennent quand vous la réactivez.

Interrupteur	Fonctionnalité
`plex_watchlists`	Les watchlists Plex deviennent des demandes
`row_title_stats`	Statistiques des titres des rangées d’Explore (Explorer) dans Appearance (Apparence)
`trakt_lists`	Clé Trakt, listes Trakt et avis Trakt. Les listes TMDB restent actives
`alert_channels_more`	Alertes par Telegram, ntfy, Gotify, Pushover et webhook. Discord et l’e-mail restent actifs
`subtitle_sites`	Sites de sous-titres et recherche de sous-titres. Votre langue de sous-titres reste active
`emby_signin`	Connexion avec Emby. L’actualisation de la bibliothèque Emby fonctionne toujours
`go_back`	Le panneau Go back (revenir en arrière) sur la page Status. Les étapes de Revenir à l’ancienne version fonctionnent sans lui

Rien n’a changé après l’ajout d’un interrupteur ? Vérifiez l’orthographe (minuscules, tirets bas) et redémarrez le conteneur, pas seulement la page.

Pour les experts

Ce que la vérification envoie

Une seule requête à api.github.com pour la version la plus récente, avec uniquement User-Agent: HolyArrs/<version>. Ni compte, ni clé, ni liste de médias. Quand la vérification est désactivée, aucune requête.

La dernière réponse est enregistrée : un redémarrage ne lance donc pas de vérification avant l’heure prévue. Une vérification attend au plus 15 s, lit au plus 512 Ko et suit au plus 3 redirections, sans jamais passer de http à https ni l’inverse. Un lien vers les notes de version ne s’affiche que s’il pointe vers les pages de versions de HolyArrs sur GitHub ; sinon, la version s’affiche en texte brut.

Release feed accepte une réponse de version au format GitHub, une liste de versions, n’importe quel JSON contenant version, ou du texte brut contenant la version. Les adresses de métadonnées cloud sont toujours refusées. Une version de test compte comme plus ancienne que la version normale.

La sauvegarde avant une mise à jour

Avant de modifier les données stockées, HolyArrs :

Vérifie qu’il y a la place pour une copie et pour la mise à jour. Sinon, rien ne change. Passez ce contrôle avec HOLYARRS_SKIP_SPACE_CHECK=yes.
Copie chaque base de données dans backups, vérifie la copie et écrit un fichier sha256 à côté. Après 3 copies ratées, rien ne change.
Lance chaque étape de mise à jour séparément et la vérifie. Une étape qui échoue est annulée ; les étapes terminées restent. Redémarrez la même version pour reprendre à l’étape qui a échoué, avec la même copie.

Après le premier démarrage réussi, la copie devient holyarrs-backup-pre-update-<time>.zip, avec une description du type « before updating from 1.1.0 to 1.2.0 ». Elle apparaît dans Settings > Backups (Paramètres > Sauvegardes) et dans holyarrs restore --list. Les 3 plus récentes sont gardées ; la planification des sauvegardes ne les supprime jamais. Une nouvelle installation, ou une mise à jour qui ne touche pas aux données, n’en crée pas.

Voir aussi

HolyArrs est gratuit. S'il vous a fait gagner du temps, mettez-lui une étoile sur GitHub, sponsorisez-le ou offrez-moi un café.