Doorgaan naar hoofdinhoud
Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

Backup en Herstel

Deze handleiding legt uit hoe je een back-up maakt en vervolgens de gegevens in je Jellyfin-installatie herstelt.

Waarom back-ups belangrijk zijn​

Back-ups zijn over het algemeen belangrijk voor alle digitale gegevens. Er zijn talloze mogelijke bugs en problemen die kunnen ontstaan en gegevensverlies kunnen veroorzaken, vooral wanneer je grote versie-upgrades uitvoert (bijvoorbeeld van Jellyfin 10.9.x naar Jellyfin 10.10.x).

Daarnaast heeft Jellyfin geen downgrade-mechanisme. Dit is cruciaal om te begrijpen: zodra je Jellyfin-installatie met een nieuwe versie is gestart, worden alle openstaande migraties direct toegepast en werken je Jellyfin-gegevens niet meer met de oude versie. De enige manier om je actieve installatie terug te zetten naar de oude versie is door een back-up te herstellen. Back-ups zijn daarom essentieel als je onstabiele versies wilt testen, of voorafgaand aan een upgrade naar de nieuwste versie. Sterker nog, bij het testen van onstabiele versies is het verstandig om veel frequenter back-ups te maken, bijvoorbeeld via een cron job of vergelijkbaar automatisch mechanisme, zodat je gegevens hersteld kunnen worden bij grote problemen.

Back-ups zijn ook nuttig als je een bug tegenkomt. Stel dat een bug in de nieuwe versie corruptie veroorzaakt in bepaalde Jellyfin-gegevens: door een back-up te herstellen kun je snel terugkeren naar intacte gegevens en eventuele oplossingen toepassen om herhaling te voorkomen. Zonder back-up zou je in zo'n situatie volledig vastlopen.

Tot slot kunnen beheerfouten, operationele problemen (zoals een volle schijf) of algemene bitrot corruptie of problemen veroorzaken die een back-upherstel vereisen. Het is altijd beter om een back-up te hebben dan niet.

Er zijn twee manieren om een back-up van je Jellyfin-gegevens te maken: via het ingebouwde back-up-/herstelsysteem of handmatig.

Ingebouwde back-upfunctie​

Jellyfins ingebouwde back-upsysteem kan een back-up maken terwijl je systeem online en actief is, in tegenstelling tot de handmatige methode die vereist dat je Jellyfin eerst stopt. In versie 10.11 raden we echter nog steeds aan om back-ups uit te voeren tijdens perioden met weinig activiteit en zonder actieve scans.

Een ingebouwde back-up maken​

Ga naar het Jellyfin-dashboard, open het tabblad Backups en klik op de knop Create Backup. In het pop-upvenster kies je welke gegevens je wilt back-uppen.

  • Database. Altijd ingeschakeld. Bevat alle gegevens uit jellyfin.db of de gebruikte databaseprovider.

  • Metadata. De inhoud van de metadatamap, inclusief metadata-afbeeldingen afhankelijk van je geselecteerde opties.

  • Subtitles. Alle geëxtraheerde ondertitels, inclusief gedownloade versies.

  • Trickplay. Alle Trickplay-gegevens die niet samen met de mediabestanden worden opgeslagen.

Het back-upsysteem controleert of er minimaal 5 GB vrije ruimte is in de back-upmap waar back-ups naartoe worden geschreven. Dit kan echter snel onvoldoende zijn als je ook ondertitels en trickplay-gegevens back-uppt, dus zorg dat je hier voldoende vrije ruimte hebt. De back-upmap bevindt zich standaard in je Jellyfin-gegevensmap:

  • Officiële Docker: <volume path>/config/data/backups waarbij <volume path> de bronlocatie van je /config volume is; dit stel je in via je docker-compose.yml of -v opties bij docker run.

  • LinuxServer.io Docker: <volume path>/config/data/data/backups waarbij <volume path> de bronlocatie van je /config volume is; dit stel je in via je docker-compose.yml of -v opties bij docker run.

  • Debian/Ubuntu-pakketten: /var/lib/jellyfin/data/backups.

  • RPMFusion Fedora/CentOS-pakketten: /var/lib/jellyfin/data/backups.

  • Windows-gebruikersinstallatie: %LOCALAPPDATA%\Jellyfin\data\backups (C:\Users\<Username>\AppData\Local\Jellyfin\data\backups)

  • Windows-service-installatie: %PROGRAMDATA%\Jellyfin\Server\data\backups (C:\ProgramData\Jellyfin\Server\data\backups)

  • MacOS-installer (.dmg): Gegevens worden opgeslagen in een van deze paden; back-up degene die bestaat: ~/.config/jellyfin/data/backups, ~/.local/share/jellyfin/data/backups, ~/Library/Application Support/Jellyfin/data/backups:

  • Draagbare installaties:

    • Linux: Gegevens worden opgeslagen in ~/.local/share/jellyfin/data/backups.
    • Windows: Gegevens en configuratie bevinden zich in C:\Users\<Username>\AppData\Local\jellyfin\data\backups, via %LOCALAPPDATA%.
    • MacOS: Gegevens worden opgeslagen in deze paden; back-up degene die bestaat: ~/.config/jellyfin/data/backups, ~/.local/share/jellyfin/data/backups, ~/Library/Application Support/Jellyfin/data/backups.

Na het klikken op Create worden alle gegevens weggeschreven naar een nieuw zip-archief.

Herstellen vanuit een ingebouwde back-up​

Om te herstellen vanuit een back-up kun je de webUI gebruiken door naar dezelfde weergave te gaan als bij de vorige stap en op de herstelknop in de back-uplijst te klikken, of je kunt Jellyfin starten met het argument --restore-archive PATH_TO_BACKUP_ZIP. Let op: bij herstel via de webUI wordt je server onmiddellijk opnieuw opgestart voor dit proces en is hij gedurende die tijd niet beschikbaar.

Handmatige back-up​

Een handmatige back-up maken komt neer op het zelf kopiëren van alle benodigde Jellyfin-gegevens.

Een handmatige back-up maken​

  1. Stop de draaiende Jellyfin-server. Dit is uiterst belangrijk omdat de database anders vergrendeld raakt en mogelijk niet hersteld kan worden bij terugzetten. Let op: dit onderbreekt eventuele actieve afspeelsessies.

    • Elk platform: Klik in het Jellyfin-dashboard op "Shutdown". Dit zou het proces netjes moeten stoppen op alle platforms. Mocht dit niet werken, probeer dan één van onderstaande methodes.
    • Docker: docker stop jellyfin
    • Debian/Ubuntu-pakketten: sudo systemctl stop jellyfin of sudo service jellyfin stop
    • Windows-installer: Rechtsklik op het systeemvakpictogram en kies "Quit"; of zoek in Taakbeheer het Jellyfin-proces en beëindig dit.
    • MacOS-installer (.dmg): Zoek in Activiteitenweergave het Jellyfin-proces en beëindig dit.
    • Draagbare installaties (alle platforms): Stop het draaiende jellyfin of jellyfin.exe programma, ongeacht hoe het gestart is.

  2. Kopieer uw datamap en configuratiemap naar een bestemming naar keuze. De naamgeving van de kopieën is aan u; persoonlijk gebruik ik datum- en versiegebaseerde mapnamen zoals jellyfin.2024-05-01_10.8.13. De locatie van deze bestanden hangt af van het platform; over het algemeen volgen ze de XDG Directory Specification op ondersteunde platforms. Meer informatie vindt u in de configuratiedocumentatie.

    OPMERKING: Dit zijn standaardlocaties; gebruik uw aangepaste paden indien gewijzigd.

    • Officiële Docker: De datamap bevindt zich waar uw /config-volume vandaan komt (gedefinieerd in docker-compose.yml of in uw -v-opties voor docker run). Deze map bevat ook de configuratiemap.
    • LinuxServer.io Docker: De configuratiemap bevindt zich waar uw /config-volume vandaan komt (gedefinieerd in docker-compose.yml of in uw -v-opties voor docker run). Deze map bevat ook de datamap.
    • Debian/Ubuntu-pakketten: Datamap: /var/lib/jellyfin, configuratiemap: /etc/jellyfin (gedefinieerd in /etc/default/jellyfin).
    • RPMFusion Fedora/CentOS-pakketten: Datamap: /var/lib/jellyfin, configuratiemap: /etc/jellyfin (gedefinieerd in /etc/sysconfig/jellyfin).
    • Windows Tray/Installer (.exe): Datamap: %PROGRAMDATA%\Jellyfin\Server (C:\ProgramData\Jellyfin\Server) of %LOCALAPPDATA%\Jellyfin (C:\Users\<Username>\AppData\Local\Jellyfin). Bevat ook de configuratiemap.
    • MacOS Installer (.dmg): Back-up deze mappen indien aanwezig: ~/.config/jellyfin/, ~/.local/share/jellyfin/, ~/Library/Application Support/Jellyfin/.
    • Draagbare installaties:
      • Linux: Datamap en configuratiemap: ~/.local/share/jellyfin.
      • Windows: Datamap: %LOCALAPPDATA%\jellyfin (C:\Users\<Username>\AppData\Local\jellyfin). Bevat ook de configuratiemap.
      • MacOS: Back-up deze mappen indien aanwezig: ~/.config/jellyfin/, ~/.local/share/jellyfin/, ~/Library/Application Support/Jellyfin/.

    Voorbeeld op Debian (kopieer beide mappen naar één doelmap):

    TIMESTAMP=$(date +%Y%m%d%H%M%S)
    VERSION=10.9.10
    sudo mkdir -p /media/backups/jellyfin.${TIMESTAMP}_${VERSION}  # Or change the path wherever in your system makes sense to you
    sudo cp -a /var/lib/jellyfin /media/backups/jellyfin.${TIMESTAMP}_${VERSION}/data
    sudo cp -a /etc/jellyfin /media/backups/jellyfin.${TIMESTAMP}_${VERSION}/config

  3. Start Jellyfin opnieuw op, na een upgrade of op de huidige versie. U hebt nu een veilige kopie van uw gegevens in het pad dat u in stap 2 hebt gekozen.

Herstellen vanuit een handmatige back-up​

Dit proces veronderstelt dat u de bovenstaande stappen hebt gevolgd om de back-up te maken.

  1. Stop het draaiende Jellyfin-serverproces.

  2. Verplaats uw huidige gegevens- en configuratiemappen naar een andere locatie (bijvoorbeeld door .bak toe te voegen). Voorbeeld: sudo mv /var/lib/jellyfin /var/lib/jellyfin.bak en sudo mv /etc/jellyfin /etc/jellyfin.bak.

  3. Kopieer - niet verplaatsen of hernoemen - uw back-up naar de oorspronkelijke naam. Voorbeeld: sudo cp -a /media/backups/jellyfin.2024-10-27_10.9.11/data /var/lib/jellyfin en sudo cp -a /media/backups/jellyfin.2024-10-27_10.9.11/config /etc/jellyfin.

  4. Installeer indien nodig nu dezelfde Jellyfin-versie als in uw back-up.

  5. Start Jellyfin opnieuw op. De server zou zonder problemen moeten opstarten met de oude gegevens, ervan uitgaande dat de versies correct zijn. Als je een downgrade hebt uitgevoerd, kan dit automatisch gebeuren.