Jellyfin – Installation und Einrichtung

Jellyfin ist ein kostenloser Open-Source-Media-Server, mit dem du deine eigenen Filme, Serien und Musik streamen kannst – ganz ohne Abo-Gebühren. Du behältst die volle Kontrolle über deine Daten, da alles lokal auf deinem NexoraHost VPS oder Rootserver läuft. Diese Anleitung führt dich durch die komplette Installation und Grundeinrichtung.

Hinweis: Detaillierte Unterseiten zu Hardware-Transkodierung, Reverse Proxy und erweiterten Einstellungen findest du in der linken Navigation.

Warum Jellyfin selbst hosten?

• Keine monatlichen Kosten oder versteckten Abos
• Volle Kontrolle über deine Medienbibliothek, keine Überwachung durch Dritte
• Apps verfügbar für Smart-TVs, Smartphones (Android/iOS), PC, Xbox und mehr
• Automatische Organisation und Metadaten-Abruf für deine Medien
• Hardware-Transkodierung für flüssige Wiedergabe auf allen Geräten
• Live-TV-Unterstützung mit Tuner oder IPTV

Voraussetzungen

• Einen VPS oder Rootserver mit Ubuntu 22.04/24.04 (andere Linux-Distributionen funktionieren ähnlich)
• SSH-Zugang mit root-Rechten
• Ausreichend Speicherplatz für deine Medien – Filme in HD-Qualität benötigen etwa 2-4 GB pro Stunde
• Eine eigene Domain mit SSL (empfohlen für sicheren Zugriff von unterwegs)

Schritt 1: Docker installieren

Docker ist die sauberste Methode, da alle Abhängigkeiten im Container isoliert sind:

# Docker installieren (Ubuntu/Debian)
sudo apt update
sudo apt install docker.io docker-compose -y

# Docker beim Systemstart aktivieren
sudo systemctl enable --now docker

# Aktuellen Benutzer zur Docker-Gruppe hinzufügen (erspart sudo bei jedem Befehl)
sudo usermod -aG docker $USER

Nach dem Hinzufügen zur Gruppe einmal ab- und wieder anmelden.

Schritt 2: Ordnerstruktur vorbereiten

Eine saubere Ordnerstruktur macht Backups und Updates einfacher:

# Hauptverzeichnis für Jellyfin
mkdir -p ~/jellyfin/{config,cache,media}

# Unterordner für verschiedene Medien-Typen (optional, aber empfohlen)
mkdir -p ~/jellyfin/media/{Filme,Serien,Musik,Fotos}

Die Unterordner helfen Jellyfin beim automatischen Erkennen und Sortieren deiner Medien.

Schritt 3: Jellyfin mit Docker-Compose starten

Docker-Compose macht die Konfiguration übersichtlicher als ein langer Docker-Befehl. Erstelle die Datei:

nano ~/jellyfin/docker-compose.yml

Füge folgenden Inhalt ein:

version: '3.8'
services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Berlin
    ports:
      - 8096:8096        # HTTP (Webinterface)
      - 8920:8920        # HTTPS (optional, wenn SSL konfiguriert)
    volumes:
      - ./config:/config
      - ./cache:/cache
      - ./media:/media:ro  # :ro = read-only, schützt vor versehentlichem Löschen
    restart: unless-stopped

Starte den Container:

cd ~/jellyfin
docker-compose up -d

Schritt 4: Jellyfin im Browser einrichten

1. Rufe http://deine-server-ip:8096 im Browser auf
2. Der Einrichtungsassistent startet automatisch
3. Sprache wählen: Deutsch oder deine bevorzugte Sprache
4. Benutzer erstellen: Vergib einen Benutzernamen und ein sicheres Passwort. Dieser Account wird dein Admin-Konto

Schritt 5: Medienbibliotheken hinzufügen

1. Klicke auf Bibliotheken → Medienbibliothek hinzufügen
2. Wähle den Inhaltstyp:
   • Filme: Für Spielfilme – erwartet einen Ordner mit Filmdateien
   • Serien: Für TV-Serien – erwartet eine Ordnerstruktur wie Serienname/Staffel 01/Folge01.mkv
   • Musik: Für Musikdateien – erkennt Alben und Interpreten automatisch
   • Fotos: Für Bildersammlungen
3. Gib einen Anzeigenamen ein (z.B. "Meine Filme")
4. Wähle den Ordner – hier /media/Filme (der Pfad im Container, nicht auf dem Host)
5. Wiederhole den Vorgang für weitere Bibliotheken (Serien, Musik usw.)

Schritt 6: Metadaten konfigurieren

Jellyfin lädt automatisch Cover, Beschreibungen und Bewertungen aus dem Internet. Konfiguriere die Quellen:

1. Gehe zu Dashboard → Bibliotheken → [Deine Bibliothek] → Verwalten
2. Unter "Metadaten-Abrufer" kannst du die Quellen priorisieren:
   • TheMovieDb: Für Filme und Serien (Standard, sehr gut)
   • TheAudioDb: Für Musik
   • OMDb: Für zusätzliche Bewertungen
3. Klicke auf Speichern und dann auf Bibliothek scannen

Schritt 7: Hardware-Transkodierung (optional, aber empfohlen)

Transkodierung wandelt Videos in Echtzeit in ein Format um, das dein Endgerät abspielen kann. Ohne GPU muss die CPU rechnen – mit GPU-Unterstützung läuft es flüssiger:

# Intel QuickSync-Unterstützung zum Docker-Compose hinzufügen
# In docker-compose.yml unter "volumes:" ergänzen:
    devices:
      - /dev/dri:/dev/dri

In Jellyfin unter Dashboard → Wiedergabe → Transkodierung die entsprechende Hardware auswählen (z.B. Intel QuickSync oder VA-API).

Schritt 8: Externen Zugriff mit SSL absichern

Damit du von unterwegs sicher auf Jellyfin zugreifen kannst, empfiehlt sich ein Reverse Proxy mit Nginx und Let's Encrypt:

# Nginx installieren
sudo apt install nginx certbot python3-certbot-nginx -y

# Nginx-Konfiguration erstellen
sudo nano /etc/nginx/sites-available/jellyfin

server {
    listen 80;
    server_name jellyfin.deine-domain.de;

    location / {
        proxy_pass http://localhost:8096;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# Seite aktivieren
sudo ln -s /etc/nginx/sites-available/jellyfin /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

# SSL-Zertifikat holen
sudo certbot --nginx -d jellyfin.deine-domain.de

Schritt 9: Apps und Clients

Jellyfin bietet offizielle Apps für fast alle Plattformen:

• Android / iOS: Kostenlos im jeweiligen App Store
• Smart-TV: Verfügbar für LG webOS, Samsung Tizen und Android TV
• Desktop: Jellyfin Media Player für Windows, macOS und Linux
• Xbox / PlayStation: Über den integrierten Browser oder per DLNA

Gib in der App einfach deine Server-URL ein (z.B. https://jellyfin.deine-domain.de) und melde dich an.

Schritt 10: Updates und Wartung

# Neueste Version pullen und Container neustarten
cd ~/jellyfin
docker-compose pull
docker-compose up -d

# Alte Docker-Images aufräumen
docker image prune -f

Häufige Probleme

Medien werden nicht erkannt:

• Prüfe die Ordnerstruktur: Filme direkt im Film-Ordner, Serien mit Unterordnern pro Staffel
• Dateinamen sollten aussagekräftig sein (z.B. Der Pate (1972).mkv)
• Manuelles Scannen: Dashboard → Bibliotheken → [Bibliothek] → Jetzt scannen

Wiedergabe ruckelt:

• Prüfe ob Transkodierung aktiv ist – der Server konvertiert das Video in Echtzeit
• Falls die CPU-Last zu hoch ist: Hardware-Transkodierung einrichten (Schritt 7)
• Alternativ: In der Jellyfin-App die Wiedergabequalität auf "Original" stellen um Transkodierung zu vermeiden

Kein Zugriff von außen:

• Prüfe ob Port 8096 (oder 443 bei Nginx) in der Firewall freigegeben ist
• Prüfe den Reverse Proxy: Läuft Nginx? Zeigt sudo nginx -t Fehler?

Ausführliche Anleitungen zu Plugins, Live-TV und erweiterten Einstellungen findest du in den Artikeln der linken Navigation.