Je eerdere apps lezen

Lees de configuratie van een eerdere app, via de app zelf of uit zijn backup, als stap 1 van een verhuizing. Lezen verandert niets in HolyArrs of in de eerdere app.

Een read (uitlezing) is de kopie die HolyArrs van de configuratie van één app maakt. Hij blijft bewaard tot je hem verhuist of verwijdert.

Een app lezen

1. Open Settings > Move from other apps (Instellingen > Overstappen van andere apps) en klik op Add an app (een app toevoegen).
2. Kies de app en dan Through the app (via de app) of From a backup (uit een backup).
3. Klik op Check connection (verbinding controleren). Je ziet de app en de versie binnen een paar seconden.
4. Start het lezen. Een grote bibliotheek kost een paar minuten. Stop reading (stoppen met lezen) stopt het; het venster sluiten doet dat niet.
5. Je ziet de uitlezing in de lijst. Voeg de volgende app op dezelfde manier toe.

Edit (wijzigen) op een rij leest die app opnieuw. Remove (verwijderen) gooit de uitlezing weg.

Keuzes

Via de app

Typ het adres en de API-sleutel van de app. Typ voor qBittorrent de gebruikersnaam en het wachtwoord, of de API-sleutel vanaf versie 5.2.

Eerdere apps staan meestal op je thuisnetwerk, dus zet de schakelaar voor het lokale netwerk aan voor het lezen. Cloud-metadata-adressen blijven geblokkeerd, en de app mag HolyArrs niet doorsturen naar een ander adres.

Uit een backup

Typ het volledige pad, op de HolyArrs-server, van een van deze:

• een backup-zip van Radarr, Sonarr, Lidarr, Prowlarr of Bazarr,
• de configuratiemap van Seerr, Overseerr, qBittorrent of SABnzbd,
• één database- of instellingenbestand.

Een uitlezing uit een backup slaat geen sleutel op.

Wat er wordt gelezen

App	Wat er wordt gelezen
Radarr, Sonarr, Lidarr	Elke film, serie (met seizoenen) of artiest: id’s, map, volgmarkering, kwaliteitsprofiel, tags, datum toegevoegd. Ook bibliotheekmappen, tags, kwaliteitsprofielen, custom formats, regels voor releasewoorden, wachtregels, naamgeving, indexers, downloadclients, lijsten, meldingen, metadata-schrijvers, uitsluitingen, taalprofielen (Sonarr v3), metadataprofielen (Lidarr) en de vertraging voor beschikbaarheid van Radarr.
Prowlarr	Indexers, app-koppelingen, synchronisatieprofielen, indexer-proxy’s, downloadclients, meldingen.
Bazarr	Ingeschakelde talen, taalprofielen, ingeschakelde ondertitelsites, standaardprofielen.
qBittorrent, SABnzbd	Adres, poort, gebruikersnaam, downloadmappen, categorieën en (SABnzbd) Usenet-servers.
Seerr, Overseerr	Mensen (naam, e-mailadres, rol, rechten, limieten voor aanvragen), standaardlimieten en elke aanvraag die wacht of is goedgekeurd: wie het vroeg, wanneer en voor welke titel. Afgeronde en geweigerde aanvragen worden alleen geteld. Avatars worden niet gelezen.

Er wordt bewust meer gelezen dan verhuisd: alles wat is gelezen maar niet verhuisd, staat op de lijst not moved (niet verhuisd), met de reden.

Sleutels en wachtwoorden

Een uitlezing bevat nooit een sleutel, wachtwoord, token of cookie, ook niet als een backup ze in leesbare tekst heeft. Elk staat onder needs re-entry (opnieuw typen nodig), bijvoorbeeld indexer "Nyaa": apiKey.

Links tellen als geheimen, omdat tokens zich erin verstoppen. Meldingslinks, adressen van RSS-feeds en vrije extra parameters blijven achter en staan in een lijst. Van een adres van een indexer blijven alleen de host en het API-pad bewaard.

De sleutel die je hebt getypt

Als de eigenaar een app leest met een getypte sleutel, bewaart HolyArrs dat adres en die sleutel in zijn versleutelde opslag. De volgende keer leest Edit opnieuw met Use the saved key (opgeslagen sleutel gebruiken) aan, en gaat de sleutel alleen naar het opgeslagen adres. HolyArrs toont hem nooit.

De opgeslagen sleutel wordt verwijderd als
je de uitlezing van die app verwijdert
een verhuizing klaar is zonder dat er iets is mislukt (bij een mislukt onderdeel blijven de sleutels bewaard, zodat je opnieuw kunt verhuizen)
je holyarrs import-secrets -forget-move-credentials uitvoert

Wie mag lezen

De eigenaar en beheerders, aangemeld met hun wachtwoord. Het overslaan van de aanmelding op het lokale netwerk telt niet. Een API-sleutel heeft de scope admin nodig.

Als het niet werkt

Symptoom	Oorzaak	Oplossing
Check connection mislukt	Het adres wordt getest vanaf de HolyArrs-server.	Gebruik een adres dat de server kan bereiken. Zet voor een app op je thuisnetwerk de schakelaar voor het lokale netwerk aan.
De sleutel is onjuist	Kopieerfout, of qBittorrent wil een gebruikersnaam.	Kopieer de sleutel opnieuw uit de instellingen van de eerdere app.
Een backup wordt geweigerd	De zip is gewijzigd, of het pad ligt buiten de container.	Gebruik de eigen backup-zip van de app, ongewijzigd, op zijn pad binnen de HolyArrs-container.
De uitlezing is te groot	Limieten per uitlezing en per server.	Verwijder oude uitlezingen die je niet meer nodig hebt.

Voor gevorderden

Verwerking van backups en limieten

Regel	Waarde
Gekopieerde bestanden	Alleen de bestanden die nodig zijn, in een privé tijdelijke map die na het lezen wordt verwijderd.
Grootte per gekopieerd bestand	Hoogstens 1 GB.
config.xml van een arr-app	Wordt nooit gekopieerd; er staat de API-sleutel in.
Database	Alleen-lezen geopend.
Helemaal geweigerd als	een item naar buiten de zip wijst, een link bevat, of een bestand veel groter uitpakt dan zijn grootte.
Backups tegelijk	1.
Bewaard per uitlezing	16 MB.
Bewaarde uitlezingen	De 50 nieuwste.

API

Route	Wat het doet
POST /api/v1/migrate/probe	Zegt welke app en versie antwoordt, of welke backup dit is.
POST /api/v1/migrate/read	Leest de hele configuratie en bewaart die.
GET /api/v1/migrate/snapshots	Toont de uitlezingen, de nieuwste eerst.
GET /api/v1/migrate/snapshots/{id}	Eén uitlezing met alles wat erin zit.
DELETE /api/v1/migrate/snapshots/{id}	Verwijdert een uitlezing en de sleutel die voor die app is opgeslagen.
GET /api/v1/migrate/saved-keys	Apps met een opgeslagen sleutel en hun adressen, nooit de sleutel. Alleen voor de eigenaar.
DELETE /api/v1/migrate/saved-keys	Verwijdert alle opgeslagen sleutels, of één met ?kind=. Alleen voor de eigenaar.

De body van probe en read noemt de app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent of sabnzbd. Voeg url toe met key (of username en password), of path. Voeg allow_local_network toe om je thuisnetwerk te bereiken en use_saved_key om de opgeslagen sleutel te gebruiken.

Gerelateerde pagina’s

• Overstappen van andere apps
• Sleutels importeren uit een bestand