Lire vos anciennes applications

Lisez la configuration d’une ancienne application, via l’application ou depuis sa sauvegarde : c’est l’étape 1 d’une migration. La lecture ne change rien dans HolyArrs ni dans l’ancienne application.

Une lecture est la copie que HolyArrs garde de la configuration d’une application. Elle est conservée jusqu’à ce que vous la migriez ou la supprimiez.

Lire une application

1. Ouvrez Settings > Move from other apps (Paramètres > Migrer depuis d’autres applications) et appuyez sur Add an app (Ajouter une application).
2. Choisissez l’application, puis Through the app (Via l’application) ou From a backup (Depuis une sauvegarde).
3. Appuyez sur Check connection (Vérifier la connexion). Vous devriez voir l’application et sa version en quelques secondes.
4. Lancez la lecture. Une grande bibliothèque prend quelques minutes. Stop reading (Arrêter la lecture) l’arrête ; fermer le panneau ne l’arrête pas.
5. Vous devriez voir la lecture dans la liste. Ajoutez l’application suivante de la même façon.

Edit (Modifier) sur une ligne relit cette application. Remove (Supprimer) jette la lecture.

Options

Via l’application

Saisissez l’adresse et la clé API de l’application. Pour qBittorrent, saisissez le nom d’utilisateur et le mot de passe, ou sa clé API à partir de la version 5.2.

Les anciennes applications se trouvent le plus souvent sur votre réseau domestique, donc activez l’interrupteur du réseau local pour la lecture. Les adresses de métadonnées cloud restent bloquées, et l’application n’a pas le droit de rediriger HolyArrs vers une autre adresse.

Depuis une sauvegarde

Saisissez le chemin complet, sur le serveur HolyArrs, de l’un de ces éléments :

• un zip de sauvegarde de Radarr, Sonarr, Lidarr, Prowlarr ou Bazarr,
• le dossier de configuration de Seerr, Overseerr, qBittorrent ou SABnzbd,
• un fichier de base de données ou de paramètres.

Les lectures depuis une sauvegarde n’enregistrent aucune clé.

Ce qui est lu

Application	Ce qui est lu
Radarr, Sonarr, Lidarr	Chaque film, série (avec ses saisons) ou artiste : identifiants, dossier, indicateur de surveillance, profil de qualité, étiquettes, date d’ajout. Aussi les dossiers de bibliothèque, les étiquettes, les profils de qualité, les formats personnalisés, les règles de mots dans les releases, les règles de délai, le nommage, les indexeurs, les clients de téléchargement, les listes, les notifications, les générateurs de métadonnées, les exclusions, les profils de langues (Sonarr v3), les profils de métadonnées (Lidarr) et le délai de disponibilité de Radarr.
Prowlarr	Indexeurs, liens vers les applications, profils de synchronisation, proxys d’indexeurs, clients de téléchargement, notifications.
Bazarr	Langues activées, profils de langues, sites de sous-titres activés, profils par défaut.
qBittorrent, SABnzbd	Adresse, port, nom d’utilisateur, dossiers de téléchargement, catégories et (SABnzbd) serveurs Usenet.
Seerr, Overseerr	Les personnes (nom, e-mail, rôle, permissions, limites de demandes), les limites par défaut, et chaque demande en attente ou approuvée : qui a demandé, quand, quoi. Les demandes terminées et refusées sont seulement comptées. Les avatars ne sont pas lus.

Lire plus que ce qui est migré est voulu : tout ce qui est lu mais pas migré apparaît dans la liste not moved (non migré) avec sa raison.

Clés et mots de passe

Une lecture ne contient jamais de clé, de mot de passe, de jeton ni de cookie, même quand une sauvegarde les contient en clair. Chacun est listé sous needs re-entry (à saisir de nouveau), par exemple indexer "Nyaa": apiKey.

Les liens comptent comme des secrets, car des jetons s’y cachent. Les liens de notification, les adresses de flux RSS et les paramètres supplémentaires en texte libre sont laissés de côté et listés. L’adresse d’un indexeur ne garde que son hôte et son chemin d’API.

La clé que vous avez saisie

Quand le propriétaire lit une application avec une clé saisie, HolyArrs garde cette adresse et cette clé dans son stockage chiffré. La fois suivante, Edit relit avec Use the saved key (Utiliser la clé enregistrée) activé, et la clé ne part que vers l’adresse enregistrée. HolyArrs ne l’affiche jamais.

La clé enregistrée est supprimée quand
vous supprimez la lecture de cette application
une migration se termine sans aucun échec (un élément en échec conserve les clés, pour que vous puissiez migrer de nouveau)
vous lancez holyarrs import-secrets -forget-move-credentials

Qui peut lire

Le propriétaire et les administrateurs, connectés avec leur mot de passe. La dispense de connexion sur le réseau local ne compte pas. Une clé API a besoin de la portée admin.

Si ça ne fonctionne pas

Symptôme	Cause	Solution
Check connection échoue	L’adresse est testée depuis le serveur HolyArrs.	Utilisez une adresse que le serveur peut joindre. Activez l’interrupteur du réseau local pour une application sur le réseau domestique.
La clé est incorrecte	Erreur de copie, ou qBittorrent attend un nom d’utilisateur.	Copiez de nouveau la clé depuis les paramètres de l’ancienne application.
Une sauvegarde est refusée	Le zip a été modifié, ou le chemin est en dehors du conteneur.	Utilisez le zip de sauvegarde de l’application, tel quel, à son chemin dans le conteneur HolyArrs.
La lecture est trop volumineuse	Des limites s’appliquent par lecture et par serveur.	Supprimez les anciennes lectures dont vous n’avez plus besoin.

Pour les experts

Traitement des sauvegardes et limites

Règle	Valeur
Fichiers copiés	Uniquement les fichiers nécessaires, dans un dossier temporaire privé, supprimé après la lecture.
Taille par fichier copié	1 Go au maximum.
config.xml d’une application arr	Jamais copié ; il contient la clé API.
Base de données	Ouverte en lecture seule.
Refusée en entier quand	une entrée pointe en dehors du zip, elle contient un lien, ou un fichier se décompresse en bien plus gros que sa taille.
Sauvegardes en même temps	1.
Conservé par lecture	16 Mo.
Lectures conservées	Les 50 plus récentes.

API

Route	Ce que ça fait
POST /api/v1/migrate/probe	Indique quelle application et quelle version répondent, ou de quelle sauvegarde il s’agit.
POST /api/v1/migrate/read	Lit toute la configuration et la conserve.
GET /api/v1/migrate/snapshots	Liste les lectures, de la plus récente à la plus ancienne.
GET /api/v1/migrate/snapshots/{id}	Une lecture avec tout ce qu’elle contient.
DELETE /api/v1/migrate/snapshots/{id}	Supprime une lecture et la clé enregistrée pour cette application.
GET /api/v1/migrate/saved-keys	Les applications qui ont une clé enregistrée et leurs adresses, jamais la clé. Propriétaire uniquement.
DELETE /api/v1/migrate/saved-keys	Supprime toutes les clés enregistrées, ou une seule avec ?kind=. Propriétaire uniquement.

Le corps de probe et de read nomme l’application : radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent ou sabnzbd. Ajoutez url avec key (ou username et password), ou path. Ajoutez allow_local_network pour atteindre votre réseau domestique et use_saved_key pour utiliser la clé enregistrée.

Voir aussi

• Migrer depuis d’autres applications
• Importer les clés depuis un fichier