Self-hosting Jellyfin on a VPS: sizing for no GPU, disk, and HTTPSJellyfin selbst hosten auf einem VPS: Dimensionierung ohne GPU, Speicherplatz und HTTPS

Read this before you buy: no GPU changes everythingLies das, bevor du kaufst: keine GPU ändert alles

Every VPS tier we sell is a KVM guest with a virtual CPU and no GPU passthrough — true of the category, not a gap in this plan. Jellyfin runs perfectly well in that environment for the workload it is actually good at: direct play, where the server reads the file off disk and hands it to the client mostly unchanged, and the client's own hardware decodes it. Direct play costs the VPS almost nothing — a few percent of one core to serve the bytes.Jeder VPS-Tarif, den wir verkaufen, ist ein KVM-Gast mit virtueller CPU und ohne GPU-Passthrough — das gilt für die ganze Kategorie, nicht als Lücke in diesem Plan. Jellyfin läuft in dieser Umgebung problemlos für die Aufgabe, für die es tatsächlich gut ist: Direct Play, bei dem der Server die Datei von der Platte liest und nahezu unverändert an den Client weiterreicht, während die Hardware des Clients selbst dekodiert. Direct Play kostet den VPS fast nichts — ein paar Prozent eines Kerns, um die Bytes auszuliefern.

Transcoding is a different job entirely. It means Jellyfin is decoding the source video and re-encoding it to a different codec or bitrate in real time, in software, on the vCPU alone, because there is no hardware encoder to hand it to. A single 1080p software transcode can already saturate a vps-standard box's two vCPUs by itself — you do not need two simultaneous transcodes to see it stutter, one is enough. Ask the same box for a second transcode at the same time and it will not gracefully degrade — playback stutters, then stalls.Transcoding ist eine völlig andere Aufgabe. Es bedeutet, dass Jellyfin das Quellvideo dekodiert und in Echtzeit in einen anderen Codec oder eine andere Bitrate neu kodiert, in Software, allein auf der vCPU, weil kein Hardware-Encoder zur Verfügung steht, an den es das abgeben könnte. Ein einziger Software-Transcode in 1080p kann die zwei vCPUs eines vps-standard-Rechners schon allein auslasten — du brauchst keine zwei gleichzeitigen Transcodes, um Ruckeln zu sehen, einer reicht. Verlangst du derselben Maschine gleichzeitig einen zweiten Transcode ab, bricht sie nicht sanft ein — die Wiedergabe ruckelt, dann bleibt sie stehen.

The fix is not a bigger CPU tier, or not only that: it is treating transcoding as the failure mode to avoid, not the workload to provision for. Pick media formats your clients already play natively — H.264 in an MP4 or MKV container is the safe default nearly every TV app, phone and browser decodes directly — and Jellyfin never has to touch the video stream. A transcode will still happen occasionally, for a subtitle format or a client on a flaky connection, and that is fine; the mistake is assuming it stays occasional when the library is full of a codec your clients cannot direct play.Die Lösung ist nicht eine größere CPU-Stufe, oder zumindest nicht nur das: Es geht darum, Transcoding als den zu vermeidenden Fehlerfall zu behandeln, nicht als die Arbeitslast, für die man plant. Wähle Medienformate, die deine Clients bereits nativ abspielen — H.264 in einem MP4- oder MKV-Container ist die sichere Standardwahl, die fast jede TV-App, jedes Telefon und jeder Browser direkt dekodiert — dann muss Jellyfin den Videostream nie anfassen. Gelegentlich passiert trotzdem ein Transcode, für ein Untertitelformat oder einen Client mit wackeliger Verbindung, und das ist in Ordnung; der Fehler liegt darin, anzunehmen, dass es gelegentlich bleibt, wenn die Bibliothek voller Codecs ist, die deine Clients nicht direkt abspielen können.

Sizing: disk decides the tier, not the CPUDimensionierung: Speicherplatz entscheidet die Stufe, nicht die CPU

Once transcoding is off the table as the normal case, what actually varies plan to plan is disk, because that is what a media library is. Our vps-standard tier is 2 vCPU, 4 GiB RAM, 80 GB disk — comfortable for Jellyfin itself, which idles lightly and only spikes RAM during a library scan, but 80 GB disk is a small library once you count anything beyond a couple of dozen films or a few TV seasons.Sobald Transcoding als Normalfall vom Tisch ist, variiert von Tarif zu Tarif eigentlich nur der Speicherplatz, denn genau das ist eine Medienbibliothek. Unser vps-standard-Tarif hat 2 vCPU, 4 GiB RAM, 80 GB Speicher — für Jellyfin selbst komfortabel, das im Leerlauf kaum Last erzeugt und nur beim Bibliotheks-Scan im RAM-Verbrauch ausschlägt, aber 80 GB Speicher sind eine kleine Bibliothek, sobald man mehr als ein paar Dutzend Filme oder ein paar TV-Staffeln zählt.

Work backwards from what you actually own: a modest 1080p film runs 4 to 8 GB, a season of a show in similar quality is easily 20 to 40 GB, and a 4K remux is 40 to 80 GB per film. The config and cache volumes stay small by comparison, so the arithmetic is really just "how much video, plus headroom so the disk never fills completely" — a full disk on Linux causes its own problems well before Jellyfin itself complains.Rechne rückwärts von dem, was du tatsächlich besitzt: Ein bescheidener 1080p-Film wiegt 4 bis 8 GB, eine Staffel einer Serie in ähnlicher Qualität kommt locker auf 20 bis 40 GB, und ein 4K-Remux liegt bei 40 bis 80 GB pro Film. Die Config- und Cache-Volumes bleiben im Vergleich dazu klein, die Rechnung ist also wirklich nur „wie viel Video, plus Puffer, damit die Platte nie vollständig voll läuft“ — eine volle Platte unter Linux verursacht ihre eigenen Probleme, lange bevor Jellyfin selbst sich beschwert.

If the library is genuinely small — the point of this guide — vps-standard's 80 GB is enough. The moment you are ripping a real collection, either move up to Pro (120 GB) or add disk as a separate volume without changing the compute tier at all; add extra storage to your VPS covers how that works on our machines. Either path is cheaper decided in advance than discovered at 100% full.Ist die Bibliothek wirklich klein — genau darum geht es in diesem Guide —, reichen die 80 GB von vps-standard. Sobald du eine echte Sammlung rippst, wechsle entweder zu Pro (120 GB) hoch oder füge Speicher als separates Volume hinzu, ohne die Compute-Stufe überhaupt zu ändern; Speicherplatz zu deinem VPS hinzufügen beschreibt, wie das auf unseren Maschinen funktioniert. Beide Wege sind billiger, wenn man sie vorab entscheidet, als wenn man sie bei 100 % Belegung entdeckt.

Getting media onto the boxMedien auf die Maschine bekommen

Jellyfin does not fetch your files for you — you need to get them onto the VPS yourself. A fresh VPS has neither /srv/jellyfin nor a media folder under it yet, and plain rsync will not create more than the last missing directory on the far side, so make the path first:Jellyfin holt deine Dateien nicht selbst ab — du musst sie selbst auf den VPS bringen. Ein frischer VPS hat weder /srv/jellyfin noch einen Medienordner darunter, und einfaches rsync legt auf der Gegenseite höchstens das letzte fehlende Verzeichnis an, also lege den Pfad zuerst an:

ssh -p 2222 user@your-vps-ip "mkdir -p /srv/jellyfin/media/Movies"

Then, for anything beyond a token test library, rsync over SSH is the right tool: it resumes, it only re-sends what changed, and it runs over the same encrypted connection you already use to manage the box.Dann, für alles jenseits einer Alibi-Testbibliothek, ist rsync über SSH das richtige Werkzeug: Es setzt fort, sendet nur das erneut, was sich geändert hat, und läuft über dieselbe verschlüsselte Verbindung, die du ohnehin schon zur Verwaltung der Maschine nutzt.

rsync -avP -e "ssh -p 2222" ./Movies/ user@your-vps-ip:/srv/jellyfin/media/Movies/

Replace 2222 with your VPS's actual SSH port — it is not the default port 22 under NAT IPv4, and connect to your VPS over SSH covers finding and using it if you have not connected before. -P shows progress and lets an interrupted transfer resume instead of restarting; for a library measured in tens or hundreds of gigabytes, that matters. A plain scp works for a handful of files but has none of that resilience for a bulk copy.Ersetze 2222 durch den tatsächlichen SSH-Port deines VPS — unter NAT-IPv4 ist das nicht der Standardport 22, und über SSH mit deinem VPS verbinden beschreibt, wie du ihn findest und nutzt, falls du dich noch nie verbunden hast. -P zeigt Fortschritt an und lässt eine unterbrochene Übertragung fortsetzen statt neu starten; bei einer Bibliothek im Bereich von Dutzenden oder Hunderten Gigabyte spielt das eine Rolle. Ein einfaches scp funktioniert für eine Handvoll Dateien, hat aber nichts von dieser Widerstandsfähigkeit für eine Massenkopie.

The compose fileDie Compose-Datei

Jellyfin ships one official image and documents three volumes worth keeping separate: configuration (the database, users, and settings), cache (thumbnails and transcode scratch space), and the media itself, mounted read-only so a bug in the server can never touch your source files.Jellyfin liefert ein offizielles Image und dokumentiert drei Volumes, die getrennt gehalten werden sollten: Konfiguration (die Datenbank, Nutzer und Einstellungen), Cache (Thumbnails und Transcode-Arbeitsfläche) und die Medien selbst, schreibgeschützt eingebunden, damit ein Fehler im Server nie deine Quelldateien anfassen kann.

services:
  jellyfin:
    image: jellyfin/jellyfin:10.10.7  # check hub.docker.com/r/jellyfin/jellyfin/tags for the current release
    restart: unless-stopped
    environment:
      - JELLYFIN_PublishedServerUrl=https://media.example.com
    volumes:
      - jellyfin_config:/config
      - jellyfin_cache:/cache
      - /srv/jellyfin/media:/media:ro
    ports:
      - "127.0.0.1:8096:8096"

volumes:
  jellyfin_config:
  jellyfin_cache:

The port is bound to 127.0.0.1 on purpose — Caddy on the same host is the only thing that should reach Jellyfin directly, and nothing on the public IP finds a raw HTTP server on 8096. /srv/jellyfin/media on the host is where the rsync above lands your files; point the bind mount at wherever you actually keep the library, mounted :ro so the container can serve it but never write into it.Der Port ist absichtlich an 127.0.0.1 gebunden — Caddy auf demselben Host soll das Einzige sein, das Jellyfin direkt erreicht, und nichts auf der öffentlichen IP findet einen rohen HTTP-Server auf 8096. /srv/jellyfin/media auf dem Host ist dort, wo das obige rsync deine Dateien ablegt; richte den Bind-Mount auf den Ort, an dem du die Bibliothek tatsächlich aufbewahrst, und binde ihn :ro ein, damit der Container sie ausliefern, aber nie hineinschreiben kann.

There is deliberately no user: line pinning the container to your host UID. Docker creates the jellyfin_config and jellyfin_cache named volumes owned root:root the first time they are used, and the official jellyfin/jellyfin image has no PUID/PGID remapping logic to fix that up the way some other images do — pin a non-root user against those volumes and Jellyfin cannot write its own database on first start. Run the image as it ships.Es gibt absichtlich keine user:-Zeile, die den Container auf deine Host-UID festnagelt. Docker erzeugt die benannten Volumes jellyfin_config und jellyfin_cache bei der ersten Nutzung im Besitz von root:root, und das offizielle jellyfin/jellyfin-Image hat keine PUID/PGID-Remapping-Logik, um das nachträglich zu korrigieren, wie es manche anderen Images tun — legst du einen Non-Root-Nutzer auf diese Volumes fest, kann Jellyfin beim ersten Start seine eigene Datenbank nicht schreiben. Lass das Image so laufen, wie es ausgeliefert wird.

First run: the setup wizard and the admin accountErster Start: der Einrichtungsassistent und das Admin-Konto

Bring the stack up, then open the server directly over the bound port from the box itself (or through an SSH tunnel) to run the first-run wizard before Caddy is even in the picture:Fahre den Stack hoch und öffne den Server dann direkt über den gebundenen Port von der Maschine selbst aus (oder über einen SSH-Tunnel), um den Einrichtungsassistenten durchzuführen, noch bevor Caddy überhaupt im Spiel ist:

docker compose up -d

Jellyfin's own setup wizard walks you through a display language, the first admin username and password, and adding your first media library by pointing it at a path inside the container — /media/Movies, if that is how you laid out the bind mount above. Do this once, correctly, rather than adding libraries piecemeal later: get the folder structure right first, since reorganising a library after Jellyfin has scanned and matched it means redoing that matching.Jellyfins eigener Einrichtungsassistent führt dich durch eine Anzeigesprache, den ersten Admin-Benutzernamen und das Passwort, und das Hinzufügen deiner ersten Medienbibliothek, indem du auf einen Pfad innerhalb des Containers zeigst — /media/Movies, falls du den Bind-Mount oben so angelegt hast. Mach das einmal, und zwar richtig, statt Bibliotheken später Stück für Stück hinzuzufügen: Bring die Ordnerstruktur zuerst in Ordnung, denn eine Bibliothek umzuorganisieren, nachdem Jellyfin sie gescannt und zugeordnet hat, bedeutet, diese Zuordnung noch einmal zu machen.

HTTPS with Caddy, and the NAT catchHTTPS mit Caddy, und der NAT-Haken

media.example.com {
    reverse_proxy 127.0.0.1:8096
}

That is the whole file — Caddy requests and renews the certificate itself the first time it sees a request for that hostname, as long as DNS already points at the machine. Point the A record first and let it settle before you start Caddy.Das ist die ganze Datei — Caddy fordert das Zertifikat an und erneuert es selbst, sobald es zum ersten Mal eine Anfrage für diesen Hostnamen sieht, solange DNS bereits auf die Maschine zeigt. Setze zuerst den A-Eintrag und lass ihn sich einpendeln, bevor du Caddy startest.

The catch is the same one every self-hosted app on NAT IPv4 runs into: our VPS plans forward a small number of ports besides the dedicated SSH port, and whether 80 and 443 are among them depends on the plan — check what your specific plan forwards before you point a domain at the box. If 443 is forwarded, the Caddyfile above works exactly as written. If it is not, Caddy can serve on whatever port you do have, and every Jellyfin client accepts a port in its server address field — https://media.example.com:8443, say — but Caddy still needs port 80 reachable to complete the certificate challenge in the first place. NAT IPv4, ports and forwarding is where to check what your plan actually forwards before you build around an assumption.Der Haken ist derselbe, auf den jede selbst gehostete App unter NAT-IPv4 stößt: Unsere VPS-Tarife leiten neben dem dedizierten SSH-Port eine kleine Anzahl weiterer Ports weiter, und ob 80 und 443 dazugehören, hängt vom Tarif ab — prüfe, was dein konkreter Tarif weiterleitet, bevor du eine Domain auf die Maschine zeigen lässt. Ist 443 weitergeleitet, funktioniert die obige Caddyfile genau so, wie sie dasteht. Ist es das nicht, kann Caddy auf jedem Port lauschen, den du tatsächlich hast, und jeder Jellyfin-Client akzeptiert einen Port in seinem Feld Serveradresse — etwa https://media.example.com:8443 —, aber Caddy braucht trotzdem Port 80 erreichbar, um die Zertifikats-Challenge überhaupt abzuschließen. NAT-IPv4, Ports und Weiterleitung ist die Stelle, um zu prüfen, was dein Tarif tatsächlich weiterleitet, bevor du um eine Annahme herum baust.

Client apps: point them at your URLClient-Apps: auf deine URL zeigen

Every official Jellyfin client — web, mobile, TV apps — asks for the same thing on first launch: a server address. Give it the full https://media.example.com URL (with the port appended if you landed on the non-standard-port path above) and sign in with the account from the setup wizard. No discovery magic is needed once the address is a real, reachable hostname with a valid certificate.Jeder offizielle Jellyfin-Client — Web, Mobilgeräte, TV-Apps — fragt beim ersten Start nach demselben: einer Serveradresse. Gib die vollständige URL https://media.example.com an (mit angehängtem Port, falls du auf dem Nicht-Standard-Port-Weg von oben gelandet bist) und melde dich mit dem Konto aus dem Einrichtungsassistenten an. Keine Discovery-Magie ist nötig, sobald die Adresse ein echter, erreichbarer Hostname mit gültigem Zertifikat ist.

Hardening: the settings that matter more than usualHärtung: die Einstellungen, die hier mehr zählen als sonst

A media server is a smaller target than a mail server, but it still sits on the open internet with real accounts behind it, so a few defaults are worth checking:Ein Medienserver ist ein kleineres Ziel als ein Mailserver, aber er steht trotzdem im offenen Internet mit echten Konten dahinter, also lohnt sich der Blick auf ein paar Standardeinstellungen:

• No open registration. Jellyfin does not ship a public sign-up flow the way some self-hosted apps do — accounts are created by an administrator from the dashboard — but confirm nobody enabled guest access while exploring settings.Keine offene Registrierung. Jellyfin liefert keinen öffentlichen Registrierungsprozess, wie es manche selbst gehosteten Apps tun — Konten werden von einem Administrator im Dashboard angelegt —, aber vergewissere dich, dass beim Herumklicken in den Einstellungen niemand den Gastzugriff aktiviert hat.
• A strong admin password, set properly in the first-run wizard. This is the account that can add libraries, manage users, and reach server-level settings.Ein starkes Admin-Passwort, richtig im Einrichtungsassistenten gesetzt. Das ist das Konto, das Bibliotheken hinzufügen, Nutzer verwalten und Einstellungen auf Serverebene erreichen kann.
• Only 443 (or your forwarded HTTPS port) exposed. The compose file above already keeps 8096 bound to loopback; do not add a 0.0.0.0:8096:8096 mapping "just to test" and forget to remove it — that is the mistake that bites later, quietly, long after you stopped thinking about it.Nur 443 (oder dein weitergeleiteter HTTPS-Port) exponiert. Die obige Compose-Datei hält 8096 bereits an Loopback gebunden; füge nicht „nur zum Testen“ ein Mapping 0.0.0.0:8096:8096 hinzu und vergiss dann, es zu entfernen — das ist der Fehler, der später zubeißt, leise, lange nachdem du aufgehört hast, daran zu denken.

Backups: the config volume is the one that mattersBackups: das Config-Volume ist das, auf das es ankommt

The media files are large but usually replaceable — you ripped them once, you can rip them again. The jellyfin_config volume is the opposite: small, and the one thing that is genuinely painful to lose, because it holds your users, watch history, watched/unwatched state, library metadata matches, and every setting you tuned.Die Mediendateien sind groß, aber meist ersetzbar — du hast sie einmal gerippt, du kannst sie wieder rippen. Das Volume jellyfin_config ist das Gegenteil: klein, und das eine, dessen Verlust wirklich schmerzt, weil es deine Nutzer, den Wiedergabeverlauf, den Gesehen/Ungesehen-Status, die Metadaten-Zuordnungen der Bibliothek und jede Einstellung enthält, die du angepasst hast.

docker run --rm \
  -v jellyfin_config:/config:ro \
  -v "$PWD":/backup \
  alpine:3.21 tar czf /backup/jellyfin-config-$(date +%F).tar.gz -C /config .

Copy that tarball off the VPS on a schedule; a backup sitting on the same disk as the service it protects does not survive that disk failing. back up your VPS covers what off-machine backup means in practice on any provider. The cache volume needs no backup at all — Jellyfin rebuilds it from scratch without complaint.Kopiere diesen Tarball planmäßig vom VPS herunter; ein Backup, das auf derselben Platte liegt wie der Dienst, den es schützt, überlebt deren Ausfall nicht. Backup deines VPS beschreibt, was Backup abseits der Maschine bei jedem Anbieter in der Praxis bedeutet. Das Cache-Volume braucht überhaupt kein Backup — Jellyfin baut es klaglos von Grund auf neu.

Updates: pin the tag, read the notesUpdates: den Tag festnageln, die Notes lesen

docker compose pull
docker compose up -d

Bump the pinned tag deliberately rather than tracking latest. Jellyfin documents breaking changes and occasional database migrations per release, and those migrations run automatically against your config volume the moment the new version starts — which is exactly why the backup above happens before an update you're not sure about, not after something goes wrong.Hebe den festgenagelten Tag bewusst an, statt latest zu verfolgen. Jellyfin dokumentiert Breaking Changes und gelegentliche Datenbank-Migrationen pro Release, und diese Migrationen laufen automatisch gegen dein Config-Volume, sobald die neue Version startet — genau deshalb passiert das Backup oben vor einem Update, bei dem du unsicher bist, nicht erst, nachdem etwas schiefgegangen ist.

On overnight.hostBei overnight.host

Full disclosure: this is what we sell. A vps-standard (4 GiB / 80 GB) suits a small library played back mostly with direct play; move up to Pro or add disk once the library grows or transcoding cannot be avoided.Zur vollen Transparenz: Das ist, was wir verkaufen. Ein vps-standard (4 GiB / 80 GB) eignet sich für eine kleine Bibliothek, die überwiegend mit Direct Play wiedergegeben wird; steige auf Pro um oder füge Speicher hinzu, sobald die Bibliothek wächst oder Transcoding sich nicht vermeiden lässt.

Linux KVM VPS — EUR 4.99 to EUR 59.99 a month, on our own single-tenant bare metal in Dallas, TX and Charlotte, NC. Full hardware virtualisation (KVM), your own kernel, full root. Six tiers, vps-starter to vps-ultra. Starter is 1 vCPU, 1 GiB RAM, 25 GB disk.Linux-KVM-VPS — 4,99 bis 59,99 EUR im Monat, auf unserer eigenen Single-Tenant-Bare-Metal-Hardware in Dallas, TX und Charlotte, NC. Vollständige Hardware-Virtualisierung (KVM), eigener Kernel, volles Root. Sechs Tarife, vps-starter bis vps-ultra. Starter hat 1 vCPU, 1 GiB RAM, 25 GB Speicher.

You order in the shop, pay by card (Stripe) or SEPA bank transfer, and your login details are e-mailed to you once the service is set up. Support is e-mail, run by one person, with no guaranteed response time. All prices are final totals under the German small-business rule (§19 UStG); no VAT is added or shown.Du bestellst im Shop, zahlst per Karte (Stripe) oder SEPA-Überweisung, und deine Zugangsdaten werden dir per E-Mail zugeschickt, sobald der Dienst eingerichtet ist. Support läuft per E-Mail, von einer einzelnen Person betrieben, ohne garantierte Reaktionszeit. Alle Preise sind Endpreise. Gemäß § 19 UStG wird keine Umsatzsteuer ausgewiesen.

Order vps-standard → · Linux KVM VPS overviewvps-standard bestellen → · Übersicht Linux-KVM-VPS

Written by the person who runs overnight.host: a small, honest hosting company on dedicated bare metal — Linux VPS, game servers, web hosting. Live status at up.overnight.host.Geschrieben von der Person, die overnight.host betreibt: ein kleines, ehrliches Hosting-Unternehmen auf dedizierter Bare-Metal-Hardware — Linux-VPS, Gameserver, Webhosting. Live-Status unter up.overnight.host.