Bisherige Apps auslesen

Fortgeschritten

Lies die Einrichtung einer bisherigen App aus, über die App selbst oder aus ihrem Backup. Das ist Schritt 1 eines Umstiegs. Das Auslesen ändert nichts in HolyArrs und nichts in der bisherigen App.

Ein read (Auslesung) ist die Kopie, die HolyArrs von der Einrichtung einer App anlegt. Sie bleibt, bis du sie überträgst oder entfernst.

Eine App auslesen

Öffne Settings > Move from other apps (Einstellungen > Umstieg von anderen Apps) und klicke auf Add an app (App hinzufügen).
Wähle die App und dann Through the app (über die App) oder From a backup (aus einem Backup).
Klicke auf Check connection (Verbindung prüfen). Du solltest nach wenigen Sekunden die App und ihre Version sehen.
Starte das Auslesen. Bei einer großen Bibliothek dauert es ein paar Minuten. Stop reading (Auslesen stoppen) bricht es ab; das Schließen des Fensters nicht.
Du solltest die Auslesung in der Liste sehen. Füge die nächste App genauso hinzu.

Edit (bearbeiten) in einer Zeile liest diese App noch einmal aus. Remove (entfernen) verwirft die Auslesung.

Optionen

Über die App

Gib die Adresse und den API-Schlüssel der App ein. Für qBittorrent gibst du Benutzername und Passwort ein, oder ab Version 5.2 den API-Schlüssel.

Bisherige Apps liegen meist in deinem Heimnetz, schalte also für das Auslesen den Schalter für das lokale Netzwerk ein. Cloud-Metadaten-Adressen bleiben gesperrt, und die App darf HolyArrs nicht an eine andere Adresse weiterleiten.

Aus einem Backup

Gib den vollständigen Pfad auf dem HolyArrs-Server zu einem dieser Dinge ein:

ein Backup-Zip aus Radarr, Sonarr, Lidarr, Prowlarr oder Bazarr,
der Konfigurationsordner von Seerr, Overseerr, qBittorrent oder SABnzbd,
eine einzelne Datenbank- oder Einstellungsdatei.

Auslesungen aus einem Backup speichern keinen Schlüssel.

Was ausgelesen wird

App	Was ausgelesen wird
Radarr, Sonarr, Lidarr	Jeder Film, jede Serie (mit Staffeln) oder jeder Künstler: IDs, Ordner, ob beobachtet, Qualitätsprofil, Tags, Datum des Hinzufügens. Außerdem Bibliotheksordner, Tags, Qualitätsprofile, Custom Formats, Regeln für Release-Wörter, Warteregeln, Benennung, Indexer, Download-Clients, Listen, Benachrichtigungen, Metadaten-Schreiber, Ausschlüsse, Sprachprofile (Sonarr v3), Metadatenprofile (Lidarr) und die Verfügbarkeitsverzögerung von Radarr.
Prowlarr	Indexer, App-Verknüpfungen, Sync-Profile, Indexer-Proxys, Download-Clients, Benachrichtigungen.
Bazarr	Aktivierte Sprachen, Sprachprofile, aktivierte Untertitel-Seiten, Standardprofile.
qBittorrent, SABnzbd	Adresse, Port, Benutzername, Download-Ordner, Kategorien und (SABnzbd) Usenet-Server.
Seerr, Overseerr	Personen (Name, E-Mail, Rolle, Berechtigungen, Anfragelimits), Standardlimits und jede wartende oder genehmigte Anfrage: wer angefragt hat, wann und was. Abgeschlossene und abgelehnte Anfragen werden nur gezählt. Avatare werden nicht ausgelesen.

Dass mehr ausgelesen als übertragen wird, ist Absicht: Alles, was ausgelesen, aber nicht übertragen wurde, steht mit seinem Grund auf der Liste not moved (nicht übertragen).

Schlüssel und Passwörter

Eine Auslesung enthält nie einen Schlüssel, ein Passwort, ein Token oder ein Cookie, auch wenn sie in einem Backup im Klartext stehen. Jeder Eintrag wird unter needs re-entry (muss neu eingegeben werden) aufgeführt, zum Beispiel indexer "Nyaa": apiKey.

Links zählen als Geheimnisse, weil sich Tokens darin verstecken. Benachrichtigungslinks, Adressen von RSS-Feeds und zusätzliche Parameter als Freitext bleiben zurück und werden aufgelistet. Von der Adresse eines Indexers bleiben nur der Host und der API-Pfad.

Der Schlüssel, den du eingegeben hast

Wenn der Besitzer eine App mit einem eingegebenen Schlüssel ausliest, legt HolyArrs diese Adresse und diesen Schlüssel in seinem verschlüsselten Speicher ab. Beim nächsten Mal liest Edit mit eingeschaltetem Use the saved key (gespeicherten Schlüssel verwenden) erneut aus, und der Schlüssel geht nur an die gespeicherte Adresse. HolyArrs zeigt ihn nie an.

Der gespeicherte Schlüssel wird gelöscht, wenn
du die Auslesung für diese App entfernst
ein Umstieg ohne Fehlschläge fertig wird (bei einem fehlgeschlagenen Eintrag bleiben die Schlüssel, damit du erneut übertragen kannst)
du `holyarrs import-secrets -forget-move-credentials` ausführst

Wer auslesen darf

Der Besitzer und Admins, mit ihrem Passwort angemeldet. Die übersprungene Anmeldung im lokalen Netzwerk zählt nicht. Ein API-Schlüssel braucht den Scope admin.

Wenn es nicht funktioniert

Symptom	Ursache	Lösung
Check connection schlägt fehl	Die Adresse wird vom HolyArrs-Server aus getestet.	Nimm eine Adresse, die der Server erreicht. Für eine App im Heimnetz schaltest du den Schalter für das lokale Netzwerk ein.
Der Schlüssel ist falsch	Fehler beim Kopieren, oder qBittorrent will einen Benutzernamen.	Kopiere den Schlüssel noch einmal aus den Einstellungen der bisherigen App.
Ein Backup wird abgelehnt	Das Zip wurde verändert, oder der Pfad liegt außerhalb des Containers.	Nimm das unveränderte Backup-Zip der App selbst, unter seinem Pfad im HolyArrs-Container.
Die Auslesung ist zu groß	Limits pro Auslesung und pro Server.	Entferne alte Auslesungen, die du nicht mehr brauchst.

Für Fortgeschrittene

Umgang mit Backups und Limits

Regel	Wert
Kopierte Dateien	Nur die nötigen Dateien, in einen privaten temporären Ordner, der nach dem Auslesen gelöscht wird.
Größe pro kopierter Datei	Höchstens 1 GB.
`config.xml` einer Arr-App	Wird nie kopiert; sie enthält den API-Schlüssel.
Datenbank	Wird schreibgeschützt geöffnet.
Wird ganz abgelehnt, wenn	ein Eintrag aus dem Zip hinaus zeigt, es einen Link enthält oder eine Datei entpackt weit größer ist als angegeben.
Backups gleichzeitig	1.
Behalten pro Auslesung	16 MB.
Behaltene Auslesungen	Die 50 neuesten.

API

Route	Was sie tut
`POST /api/v1/migrate/probe`	Sagt, welche App und Version antwortet oder welches Backup das ist.
`POST /api/v1/migrate/read`	Liest die ganze Einrichtung aus und behält sie.
`GET /api/v1/migrate/snapshots`	Listet Auslesungen auf, die neueste zuerst.
`GET /api/v1/migrate/snapshots/{id}`	Eine Auslesung mit allem, was sie enthält.
`DELETE /api/v1/migrate/snapshots/{id}`	Entfernt eine Auslesung und den für diese App gespeicherten Schlüssel.
`GET /api/v1/migrate/saved-keys`	Apps mit gespeichertem Schlüssel und ihre Adressen, nie der Schlüssel. Nur für den Besitzer.
`DELETE /api/v1/migrate/saved-keys`	Löscht jeden gespeicherten Schlüssel, oder einen mit `?kind=`. Nur für den Besitzer.

Der Body von probe und read nennt die App: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent oder sabnzbd. Füge url mit key (oder username und password) hinzu, oder path. Füge allow_local_network hinzu, um dein Heimnetz zu erreichen, und use_saved_key, um den gespeicherten Schlüssel zu verwenden.