Registration für Jellyfin — Installationsanleitung

Installation

Du brauchst Jellyfin Server 12.2 oder neuer und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (ein aktives Abonnement, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Paket oder den kostenlosen 30-tägigen Testzeitraum).

Über dein Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann von selbst.

Öffne in deinem MediaLab-Works-Konto Lizenzen → Jellyfin-Plugin-Repository und klicke auf Adresse erstellen. Kopiere sie: Sie ist privat (sie enthält einen Token), teile sie also nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
Öffne in Jellyfin Dashboard → Erweiterungen → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
Finde im Dashboard → Erweiterungen → Katalog den Eintrag Registration by MediaLab, klicke auf Installieren und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die Versionen, die sie erlauben. Seine Download-Links sind signiert und laufen nach ein paar Stunden ab, deshalb liest Jellyfin immer eine frische Liste.

Über den öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build; medialab Server fügt ihn von selbst hinzu. Du kannst ihn auf dieselbe Weise hinzufügen, um ein Plugin zu installieren, bevor du einen Schlüssel hast: Das Plugin fragt dann auf seiner Lizenzseite nach der Lizenz oder startet den Testzeitraum. Bei einer Lifetime-Lizenz, deren Update-Zeitraum endete, bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell aus einer Zip-Datei.

Lade in Konto → Lizenzen jf-registration_x.y.z.zip herunter (die SHA-256 der Datei steht neben dem Button).
Entpacke sie in einen neuen Ordner Registration by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner:
- Linux (Paket): /var/lib/jellyfin/plugins/
- Docker (offizielles Image): /config/plugins/ im Konfigurations-Volume
- Windows: %ProgramData%\Jellyfin\Server\plugins\
Starte Jellyfin neu.

Lizenzaktivierung

Öffne die Plugin-Seite unter Dashboard → Erweiterungen → Registration by MediaLab und klicke auf Open License page.
Füge deinen Lizenzschlüssel ein und klicke auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Jellyfin-Server und zeigt die Lizenz als Active an.
Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein und starte den kostenlosen 30-tägigen Testzeitraum (Karte erforderlich, heute nichts zu zahlen) oder kaufe eine Lizenz; das Plugin aktiviert sich, sobald die Zahlung erledigt ist.

Die Lizenz wird einmal am Tag und bei jedem Start von Jellyfin geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter. Ohne gültige Lizenz stoppt das Plugin seine Arbeit, und nur seine License-Seite funktioniert weiter (Testzeitraum, Schlüssel, Verlängerung); es wird nichts gelöscht, und alles läuft weiter, sobald die Lizenz wieder gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Updates und Rollback

Aus dem Repository: Jellyfin zeigt neue Versionen unter Dashboard → Erweiterungen an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
Über die Lizenzseite des Plugins: Mit gültiger Lizenz installiert Install update die neueste Version, die deine Lizenz erlaubt, und Roll back to x.y.z geht zur vorherigen Version zurück (zum Beispiel, wenn nach einem Update etwas nicht mehr funktioniert). Starte Jellyfin nach beidem neu. Beide Pakete werden gegen die Prüfsumme geprüft, die der Lizenzserver veröffentlicht.
Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums erschienen sind; danach läuft das Plugin mit der letzten Version weiter, die es nutzen darf.
Nach Roll back to x.y.z ist die automatische Aktualisierung von Jellyfin für dieses Plugin ausgeschaltet, bis zum nächsten Install update auf der Lizenzseite, damit die geplante Aufgabe Update Plugins (beim Start und täglich) die neuere Version nicht zurückholt.
Lifetime-Lizenz und automatische Updates. Der öffentliche Jellyfin-Katalog (https://medialab.works/jellyfin/manifest.json) bietet immer die neueste Version an. Wenn der Update-Zeitraum einer Lifetime-Lizenz endete, sind später erschienene Versionen nicht lizenziert: Wenn Jellyfins automatische Plugin-Updates so eine Version installieren, stoppt das Plugin mit „version not licensed", bis du auf seiner Lizenzseite mit Roll back to x.y.z zurückgehst oder einen Update-Pass kaufst. Um das zu vermeiden, lass Jellyfin dieses Plugin nicht automatisch aktualisieren: Füge dein privates Plugin-Repository hinzu, das nur die Versionen anbietet, die deine Lizenz erlaubt, anstelle des öffentlichen Katalogs, oder entferne die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Geplante Aufgaben (das stoppt automatische Updates für jedes Plugin).

Quellcode

Der GPL-3.0-Quellcode jeder Version liegt in Konto → Lizenzen (Quellcode) neben dem Download als .tar.gz-Archiv, erzeugt aus dem exakten Commit dieser Version.

Konfiguration

Öffne Dashboard → Registration. Nach der Installation ist die Registrierung geschlossen: Nichts öffnet sich von selbst.

Tab	Was du einstellst
General	Modus (Freigabe, Einladungscode, automatisch), Registration open, optionales Start- und Enddatum, öffentliche Adresse des Servers (für E-Mail-Links).
Default access	Mediatheken (alle oder ausgewählte), gleichzeitige Wiedergaben, Bitrate für Fernzugriff, automatische Deaktivierung nach einer Anzahl von Tagen.
Form	Standardland, erlaubte Länder, Regeln für Benutzername und Passwort, Datenschutztext.
Anti-bot	Turnstile-Schlüssel (optional), Blockieren von Rechenzentrums- / VPN- / Tor-Adressen, Länder der Besucher, Regeln für Doppelkonten.
Invitations	Der aktuelle Einladungscode und der Familiencode.
Notifications	Aktivitätsprotokoll von Jellyfin, E-Mail (SMTP) und Telegram.
Send access	Link und QR-Code der Seite, bereit zum Verschicken.

Tägliche Nutzung

Schicke den Link der Seite (oder den Einladungscode) an die Person.
Die Anfrage erscheint unter Requests; genehmige oder lehne sie ab. Bei Genehmigung wird das Konto mit dem von dir gesetzten Standardzugang aktiviert.
Teste die Seite selbst, während du in demselben Browser als Administrator bei Jellyfin angemeldet bist: Du bekommst das Formular direkt, ohne Code, und die Anfrage wird als Test markiert.

Fehlerbehebung

Die Seite sagt, die Registrierung sei geschlossen: Schalte Registration open im Tab General ein (und prüfe das Start- / Enddatum).
„Not available from this network": Der Besucher hat eine Rechenzentrums-, VPN- oder Tor-Adresse; schalte die Regel in Anti-bot aus, wenn du sie brauchst.
Hinter Cloudflare oder einem Reverse Proxy: Stelle sicher, dass die echte Besucher-Adresse Jellyfin erreicht (Jellyfins Einstellung Known proxies), sonst teilen sich alle Besucher eine Adresse und stoßen an die Ratenlimits.