# Jellyfin – Installation und Einrichtung

Jellyfin – Installation und Einrichtung – Self-Hosting Anleitung auf deinem NexoraHost Server.

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

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

## Schritt 5: Medienbibliotheken hinzufügen

    - Klicke auf **Bibliotheken → Medienbibliothek hinzufügen**
- 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

    
- Gib einen Anzeigenamen ein (z.B. "Meine Filme")
- Wähle den Ordner – hier `/media/Filme` (der Pfad im Container, nicht auf dem Host)
- 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:

    - Gehe zu **Dashboard → Bibliotheken → [Deine Bibliothek] → Verwalten**
- 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

    
- 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.*