Doorgaan naar hoofdinhoud

Upgrades en Downgrades

Onofficiële Beta-vertaling

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

Dit document geeft details over upgraden en downgraden tussen Stable en Unstable releases, en waarom je dit zou willen doen.

Stable versus Unstable​

Welke installatietype je kiest hangt af van je behoeften; uiteindelijk is Unstable bedoeld voor het testen van nieuwe functies, terwijl Stable geschikt is voor het stabiel draaien van een server voor anderen.

  • Stable biedt de meest consistente en voorspelbare gebruikerservaring. Een specifieke major release (bijv. 10.8.z, 10.9.z) introduceert, verwijdert of verandert geen belangrijke functies of functionaliteit (met kleine uitzonderingen voor beveiliging). Bugfixes worden geleverd in point releases, die worden uitgebracht wanneer nodig tijdens de levenscyclus van de major release als reactie op bugfixes en beveiligingsadviezen. De meeste gebruikers zouden over het algemeen Stable releases moeten gebruiken, omdat dit maximale uptime en consistentie garandeert voor je eindgebruikers.

  • Unstable biedt de meest actuele, geavanceerde functies, maar kan snelle en onvoorspelbare breaking changes of ernstige bugs bevatten, en heeft beperktere clientondersteuning naarmate API-wijzigingen worden doorgevoerd. Unstable releases worden wekelijks beschikbaar gesteld via binaire builds op maandagochtend rond 5:00 uur UTC, of door eigen packages te bouwen vanuit de master code branches.

Daarnaast wordt Unstable gebruikt om aanstaande releases te testen tijdens de major release-cyclus, omdat we geen beta-builds aanbieden. Als je ons wilt helpen met het testen van komende releases - en we vragen iedereen die dat kan om dit te doen - moet je de Unstable builds enige tijd draaien voordat je terugschakelt naar Stable bij de release.

Wat bedoel je met "geen beta-builds"?​

Vanwege de enorme complexiteit van het inpakken van Jellyfin voor meerdere unieke platforms, en zeker met de extra builds van derden, hebben we besloten vanaf release 10.9.0 geen expliciet getagde pre-release builds meer aan te bieden. Dit is vrij ongebruikelijk voor gratis en opensource-software, maar is een praktische noodzaak om onze major releases te stroomlijnen en hun cadans te verhogen.

Als compensatie gebruiken we een feature freeze-periode voor grote breaking changes vóór major releases, en zetten we onze geplande wekelijkse Unstable builds in als alternatief. Vóór elke major release kondigen we een schema aan van de komende Unstable releases en hoe je deze kunt koppelen aan hypothetische "beta"- en "release candidate"-versies. Bijvoorbeeld: met een bevriezing van 4 weken kunnen we de eerste 3 weken van Unstable builds als "beta" beschouwen en de laatste week als "release candidate". Wil je vroeg testen? Probeer het dan in de eerste 3 weken; wacht je liever tot alles min of meer stabiel is? Wacht dan tot de laatste week.

Hoewel dit systeem niet perfect is, stroomlijnt het de versiebeheer aanzienlijk, helpt het ons een derde repository-component/label te vermijden, en geeft het Unstable builds wat meer aandacht rond releases, terwijl er zeer weinig extra administratieve overhead is in vergelijking met expliciete pre-release versies.

Waarschuwingen en opmerkingen​

Maak back-ups​

Over het algemeen kun je, nadat je naar een Unstable versie bent geüpgraded vanaf een bepaalde Stable versie, niet eenvoudig terugdowngraden naar die originele Stable versie. Dit komt omdat Unstable versies waarschijnlijk wijzigingen hebben aangebracht in databaseschema's, configuratie-items en andere metadata, waar de oudere Stable versie niet mee overweg kan.

De enige manier om van Unstable terug te gaan naar een oudere Stable is door een backup te herstellen, of je gegevens volledig te wissen en opnieuw te beginnen. De uitzondering is migreren van Unstable naar een nieuw uitgebrachte Stable major versie op het moment dat die Stable versie wordt uitgebracht.

Maak altijd een backup van je instantiegegevens en configuratiedirectories voordat je om welke reden dan ook naar Unstable upgrade. Je weet nooit wat er mis kan gaan: een mislukte migratie, een breaking bug die een downgrade noodzakelijk maakt, of andere corruptie. Dit geldt zelfs voor testen vlak voor een Stable release. Het is altijd beter om een backup klaar te hebben, direct na de upgrade wat tests uit te voeren, en terug te draaien als dingen niet goed werken - nadat je je bug hebt gerapporteerd, natuurlijk!

Je kunt bepaalde plugins gebruiken om hierbij te helpen, bijvoorbeeld de Trakt-plugin om kijkstatus te synchroniseren, maar dit behoudt niet per se alles. Wees dus voorzichtig en ken de beperkingen voordat je verder gaat.

Volg het hier in de documentatie beschreven proces voor meer details.

Schakel automatische updates uit bij Unstable​

Automatische updates gebruiken tijdens Unstable of pre-releasetests kan problemen veroorzaken. Update altijd handmatig en test daarna. We raden automatische updates over het algemeen af, zelfs bij Stable, omdat je release notes van nieuwe versies kunt missen. We begrijpen de wenselijkheid, maar weersta de verleiding bij Unstable om belangrijke wijzigingen niet te missen.

Upgraden van Stable naar Unstable​

De exacte details van dit proces hangen af van uw platform en installatiemethode. Dit document beschrijft de twee populairste methoden: Debian/Ubuntu-pakketten via onze repository en Docker. Het proces is over het algemeen vergelijkbaar voor andere methoden (zoals handmatige downloads, Windows-installatieprogramma's, etc.), waarbij de exacte details verschillen; voor platformspecifieke informatie zie de subartikelen onder Jellyfin Server testen.

We gaan ervan uit dat je al Jellyfin Stable gebruikt.

Plugins (van Stable naar Unstable)​

Plugins voor Stable en Unstable worden in aparte repositories met eigen versienummers aangeboden. Dit voorkomt onbedoelde incompatibiliteiten en stelt ons in staat Unstable-plugins sneller uit te brengen vanwege wijzigingen in de master-branch. Schakel over naar de Unstable-pluginrepository als je plugins gebruikt. Doe je dit vóór de upgrade, dan worden plugins daarna automatisch bijgewerkt.

Plugins zijn zo versienummerd dat Unstable-plugins naadloos upgraden van de nieuwste Stable-pluginversie naar een Unstable-pluginversie, en vervolgens een naadloze upgrade van de Unstable-versie naar de volgende Stable-versie mogelijk maken (bijv. 13.0.0.0 Stable → 13.2024.0429.0 Unstable → 14.0.0.0 Stable).

  1. Ga in je Jellyfin-serverinstantie naar Dashboard → Plugins → Repositories.

  2. Verwijder de standaard "Stable"-repository via de prullenbakknop.

  3. Voeg met de "+"-knop een nieuwe repository toe. Geef deze een naam naar keuze en gebruik deze Repository URL:

    https://repo.jellyfin.org/files/plugin-unstable/manifest.json

Debian/Ubuntu-repositories (van Stable naar Unstable)​

  1. Bewerk /etc/apt/sources.list.d/jellyfin.sources en voeg unstable toe aan de Components:-regel. Verwijder main niet, voeg unstable eenvoudigweg toe:

    ...
    Components: main unstable
    ...

  2. Voer sudo apt-get update uit.

  3. Voer sudo apt-get upgrade uit om de Jellyfin-pakketten bij te werken. Jellyfin start automatisch opnieuw op.

  4. Na het opstarten worden plugins automatisch bijgewerkt naar Unstable-versies als je de repository eerder hebt aangepast. Wacht tot Jellyfin volledig is opgestart en start de service opnieuw (via de "Opnieuw starten"-knop of systemctl-commando's) om de upgrade te voltooien.

Docker (van Stable naar Unstable)​

  1. Stop uw Jellyfin-container.

  2. Pull de jellyfin/jellyfin:unstable image-tag.

  3. Start een nieuwe Jellyfin-container met de bijgewerkte image.

Upgraden van Unstable naar Stable bij release​

Wanneer een nieuwe hoofdversie van Jellyfin wordt uitgebracht, is het mogelijk - tot de volgende gepubliceerde Unstable-release - om rechtstreeks van Unstable naar de nieuwe Stable te upgraden. Dit biedt een migratiepad voor Unstable-testers om vóór de release naar de daadwerkelijke Stable-release over te stappen.

Als onderdeel van het releaseproces worden wekelijkse Unstable-builds tijdelijk 1-2 weken uitgeschakeld om een venster voor deze overstap te creëren, waarna ze normaal worden hervat. Als je op Unstable wilt blijven, kun je eenvoudigweg wachten, anders volg je het proces hier om 'terug' te upgraden naar de nieuwe Stable-versie.

De exacte details van dit proces hangen af van je platform en installatiemethode. Dit document behandelt de twee meest populaire: Debian/Ubuntu-pakketten via onze repository en Docker. Het proces is in grote lijnen hetzelfde voor andere methoden (bijv. handmatige downloads, Windows-installatieprogramma's, enz.) waarbij de exacte details verschillen; voor platformspecifieke informatie raadpleeg je de onderliggende artikelen onder "Testing Jellyfin Server".

We gaan ervan uit dat u al Jellyfin Unstable-releases gebruikt.

Plugins (Van Unstable naar Release)​

We bieden plugins voor Stable- en Unstable-releases in aparte repositories met aparte versienummering. Je moet (terug)schakelen naar de Stable-pluginrepository als je plugins gebruikt, om te voorkomen dat je toekomstige incompatibele versies van Unstable-plugins installeert op je Stable-installatie. Let op: plugins zijn mogelijk enkele uren tot dagen na een nieuwe release niet beschikbaar, afhankelijk van de plugin; als ze al beschikbaar zijn en je deze stappen volgt, zouden ze automatisch moeten upgraden bij het terugschakelen naar Stable.

Plugins zijn zo versienummerd dat Unstable-plugins naadloos upgraden van de nieuwste Stable-pluginversie naar een Unstable-pluginversie, en vervolgens een naadloze upgrade van de Unstable-versie naar de volgende Stable-versie mogelijk maken (bijv. 13.0.0.0 Stable → 13.2024.0429.0 Unstable → 14.0.0.0 Stable).

  1. Ga in je Jellyfin-serverinstantie naar Dashboard → Plugins → Repositories.

  2. Verwijder de "Unstable"-repository door op de prullenbakknop te klikken.

  3. Voeg een nieuwe repository toe met de "+"-knop. Geef de repository een willekeurige naam ("Stable" is de standaard) en gebruik de volgende Repository URL:

    https://repo.jellyfin.org/files/plugin/manifest.json

Debian/Ubuntu (Van Unstable naar Release)​

  1. Bewerk je /etc/apt/sources.list.d/jellyfin.sources en verwijder unstable van de Components:-regel:

    ...
    Components: main
    ...

  2. Voer sudo apt-get update uit.

  3. Voer sudo apt install jellyfin=<version> jellyfin-server=<version> jellyfin-web=<version> uit. Vervang <version> door het gewenste versienummer, bijvoorbeeld 10.9.1+ubu2204. Hiermee installeer je de Stable-versie over de Unstable-versie. Jellyfin start automatisch opnieuw op.

    Voorbeeld: sudo apt install jellyfin=10.9.1+ubu2204 jellyfin-server=10.9.1+ubu2204 jellyfin-web=10.9.1+ubu2204

Docker (Van Unstable naar Release)​

  1. Stop uw Jellyfin-container.

  2. Haal de jellyfin/jellyfin:latest image-tag op.

  3. Start een nieuwe Jellyfin-container met de bijgewerkte image.

Na installatie (Van Unstable naar Release)​

  1. Zodra bijgewerkte plugins beschikbaar komen, zou Jellyfin deze automatisch moeten upgraden naar de volgende stabiele versie zoals hierboven beschreven. Als je plugins tegenkomt die niet upgraden, probeer ze dan handmatig bij te werken.

Downgraden van Unstable naar een oudere Stable​

Zoals eerder vermeld, vereist dit proces het terugzetten van een backup die je hebt gemaakt voordat je voor het eerst naar Unstable upgrade.

De exacte details van dit proces hangen af van uw platform en installatiemethode. Dit document beschrijft de twee populairste methoden: Debian/Ubuntu-pakketten via onze repository en Docker. Het proces is over het algemeen vergelijkbaar voor andere methoden (zoals handmatige downloads, Windows-installatieprogramma's, etc.), waarbij de exacte details verschillen; voor platformspecifieke informatie zie de subartikelen onder Jellyfin Server testen.

We gaan ervan uit dat u al Jellyfin Unstable-releases gebruikt.

Debian/Ubuntu (van Unstable naar Oude Stable)​

  1. Stop Jellyfin via de servicemanager (sudo service jellyfin stop of vergelijkbaar). Controleer of Jellyfin daadwerkelijk is gestopt.

  2. Herstel uw back-up van de configuratie- en datamappen. Verwijder eerst de huidige inhoud volledig (of verplaats deze).

  3. Bewerk uw /etc/apt/sources.list.d/jellyfin.sources en verwijder unstable van de Components: regel.

    ...
    Components: main
    ...

  4. Voer sudo apt-get update uit.

  5. Voer sudo apt-get install --reinstall jellyfin jellyfin-server jellyfin-web uit. Hiermee wordt de nieuwe Stable-versie geforceerd over de Unstable-versie geïnstalleerd. Jellyfin zou automatisch moeten starten; zo niet, start Jellyfin dan via de servicemanager (sudo service jellyfin start of vergelijkbaar).

Docker (van Unstable naar Oude Stable)​

  1. Stop uw Jellyfin-container.

  2. Herstel uw back-up van de configuratie- en datamappen. Verwijder eerst de huidige inhoud volledig (of verplaats deze).

  3. Pull de jellyfin/jellyfin:latest image-tag.

  4. Start een nieuwe Jellyfin-container met de bijgewerkte image.

Na installatie (van Unstable naar Oude Stable)​

  1. Uw back-up zou uw oorspronkelijke pluginrepository en pluginversies moeten hebben hersteld. Zo niet, dan moet u mogelijk Unstable-plugins verwijderen en opnieuw installeren; de configuratie blijft hierbij behouden.