Homelab · Médiá NÁVOD 20. apríla 2026 · 8 min čítania

Tautulli — inštalácia a prepojenie s Plexom

Kompletný návod: Docker Compose stack, Docker sieť pre komunikáciu s Plexom, získanie Plex API kľúča a Setup Wizard krok za krokom. Funguje na Synology NAS, Linuxe aj Windowse.

Ak si čítal môj článok o Tautulli, vieš prečo to chceš. Tu je kompletný postup od inštalácie po funkčné prepojenie s Plexom.

Čo potrebuješ

Predpoklady

Plex bežiaci v Dockeri — kontajner sa musí volať PlexHW (alebo vieš jeho container name). Docker sieť tunnel-net z Cloudflare Tunnel návodu — alebo vytvoríš novú. Portainer nainštalovaný.

1. Vytvor priečinok

mkdir -p /volume1/docker/tautulli

mkdir -p ~/docker/tautulli

Vytvor v Prieskumníkovi:
C:\docker\tautulli

2. Docker Compose stack

V Portainer: Stacks → Add stack → Web editor:

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - /volume1/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Bratislava
      PUID: 1026          # ZMEŇ NA SVOJE UID
      PGID: 100           # ZMEŇ NA SVOJE GID
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - ~/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Bratislava
      PUID: 1000
      PGID: 1000
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - C:/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Bratislava
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

⚠️ Prečo tunnel-net

Tautulli a Plex musia byť v rovnakej Docker sieti aby spolu mohli komunikovať cez container name. Ak nemáš tunnel-net, vytvor sieť príkazom docker network create tunnel-net a potom pripoj Plex kontajner: docker network connect tunnel-net PlexHW.

Klikni Deploy the stack.

3. Získanie Plex API kľúča

Tautulli potrebuje Plex token pre prístup k API. Najjednoduchší spôsob ako ho získať:

Krok 1 — Otvor Plex v prehliadači a spusti ľubovoľné video v knižnici.

Krok 2 — Klikni na tri bodky (⋮) pri videu → Get Info → v dialógu klikni View XML.

Krok 3 — V URL prehliadača nájdi parameter X-Plex-Token=. Hodnota za rovnítkom je tvoj API token — skopíruj ho.

Alternatívny spôsob — cez Plex nastavenia

Prihlás sa na plex.tv → klikni na avatar vpravo hore → Account Settings. V URL prehliadača uvidíš niečo ako https://app.plex.tv/desktop#!/account?token=XXXXX — token je za token=.

4. Setup Wizard — prepojenie s Plexom

Otvor http://192.168.1.100:8181 (nahraď IP svojho NAS). Tautulli spustí Setup Wizard.

Krok 1 — Plex Media Server

Plex Host: PlexHW — container name, nie IP adresa!
Port: 32400
Use SSL: vypnuté (ak Plex nebeží na HTTPS)
Plex Token: vlož token z kroku 3
Klikni Verify — mal by si uvidieť zelené "Server found"

⚠️ PlexHW nie localhost

V poli Plex Host zadaj container name svojho Plex kontajnera — nie localhost, nie IP adresu. localhost by znamenalo samotný Tautulli kontajner. Container name funguje cez Docker DNS — ale len ak sú oba v rovnakej sieti (tunnel-net).

Krok 2 — Vyber knižnice ktoré chceš sledovať → Next → Finish.

5. Prehľad dashboardu

Čo kde nájdeš

Home / Activity — aktívne streamy v reálnom čase. Pre každý stream vidíš: používateľ, zariadenie, kodek, rozlíšenie, Direct Play / Transcode a CPU záťaž.

History — kompletná história sledovania. Filter podľa používateľa, obsahu alebo dátumu.

Statistics — najpopulárnejší obsah, najpopulárnejší používatelia, denné/týždenné štatistiky, hodiny s najvyššou aktivitou.

Libraries — prehľad knižnice s metadátami. Vidíš čo máš a čo sa sleduje.

Users — detail každého používateľa — história, obľúbený obsah, zariadenia.

6. Notifikácie (voliteľné)

Tautulli → Settings → Notification Agents. Môžeš nastaviť:

Email — pri začatí/ukončení streamu
Telegram — push notifikácia na telefón
Ntfy / Pushover / — pre pokročilých

Odporúčam aspoň nastaviť notifikáciu na nové zariadenie — hneď vieš ak sa niekto prihlásil z neznámeho zariadenia.

Troubleshooting

⚠️ "Server not found" pri Verify

Tautulli nevidí Plex. Skontroluj: (1) container name je správny — docker ps zobrazí presný názov, (2) oba kontajnery sú v tunnel-net — over cez docker network inspect tunnel-net, (3) Plex beží — skontroluj logy v Portaineri.

⚠️ Token nefunguje / "Unauthorized"

Token mohol expirovat alebo bol skopírovaný nesprávne. Opakuj postup z kroku 3 — otvor View XML znovu a skopíruj token z URL. Daj pozor na medzery na začiatku alebo konci.

⚠️ História sa nezaznamenáva

Plex musí mať povolené zdieľanie dát s Tautulli. V Plex: Settings → Troubleshooting → Enable Plex Media Server Logging — zapni. Tiež skontroluj Settings → Network → Enable local network discovery.

⚠️ Zariadenia sa zobrazujú ako "Unknown"

Tautulli používa GeoIP databázu ktorá sa musí stiahnuť. Počkaj 5-10 minút po inštalácii, potom reštartuj kontajner. Settings → GeoLite2 Database — klikni Update.

⚠️ Tautulli beží ale Plex nevidí aktívne streamy

Skontroluj či Plex token patrí účtu ktorý má admin prístup na Plex server. Shared user tokeny nefungujú — použiť token musíš od správcu servera (vlastníka).

Homelab · Medien ANLEITUNG 20. April 2026 · 8 Min. Lesezeit

Tautulli — Installation und Plex-Verbindung

Vollständige Anleitung: Docker Compose Stack, Docker-Netzwerk für die Plex-Kommunikation, Plex API-Schlüssel abrufen und Setup-Wizard Schritt für Schritt.

Wenn du meinen Tautulli-Artikel gelesen hast, weißt du warum du das willst. Hier ist der vollständige Ablauf von der Installation bis zur funktionierenden Plex-Verbindung.

Was du brauchst

Voraussetzungen

Plex läuft in Docker — Container heißt PlexHW (oder du kennst seinen Container-Namen). Docker-Netzwerk tunnel-net aus der Cloudflare Tunnel Anleitung — oder du erstellst ein neues. Portainer installiert.

1. Verzeichnis erstellen

mkdir -p /volume1/docker/tautulli

mkdir -p ~/docker/tautulli

Im Explorer erstellen:
C:\docker\tautulli

2. Docker Compose Stack

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - /volume1/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Berlin
      PUID: 1026          # DEINE UID
      PGID: 100           # DEINE GID
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - ~/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Berlin
      PUID: 1000
      PGID: 1000
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - C:/docker/tautulli:/config:rw
    environment:
      TZ: Europe/Berlin
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

⚠️ Warum tunnel-net

Tautulli und Plex müssen im selben Docker-Netzwerk sein um über den Container-Namen zu kommunizieren. Falls tunnel-net nicht existiert: docker network create tunnel-net und dann Plex verbinden: docker network connect tunnel-net PlexHW.

3. Plex API-Schlüssel abrufen

Schritt 1 — Plex im Browser öffnen und ein beliebiges Video in der Bibliothek starten.

Schritt 2 — Drei-Punkte-Menü (⋮) beim Video → Get Info → im Dialog View XML klicken.

Schritt 3 — In der Browser-URL den Parameter X-Plex-Token= finden. Der Wert nach dem Gleichheitszeichen ist dein API-Token — kopieren.

Alternativer Weg — über Plex-Einstellungen

Auf plex.tv einloggen → Avatar oben rechts → Account Settings. In der Browser-URL steht token=XXXXX — der Token ist der Wert nach token=.

4. Setup-Wizard — Plex verbinden

http://192.168.1.100:8181 im Browser öffnen. Tautulli startet den Setup-Wizard.

Plex Host: PlexHW — Container-Name, nicht IP-Adresse!
Port: 32400
Plex Token: Token aus Schritt 3 einfügen
Verify klicken — grünes "Server found" sollte erscheinen

⚠️ PlexHW, nicht localhost

Im Feld Plex Host immer den Container-Namen eingeben — nicht localhost, nicht IP-Adresse. localhost würde den Tautulli-Container selbst bedeuten. Container-Name funktioniert über Docker DNS — aber nur wenn beide im selben Netzwerk (tunnel-net) sind.

5. Dashboard-Überblick

Was wo zu finden ist

Activity — aktive Streams in Echtzeit mit Gerät, Codec, Direct Play/Transcode und CPU-Last.

History — komplette Streaming-Historie, filterbar nach Nutzer, Inhalt oder Datum.

Statistics — beliebtester Inhalt, aktivste Nutzer, Tages-/Wochenstatistiken und Spitzenstunden.

Users — Detail pro Nutzer mit Historie, Lieblingsinhalt und genutzten Geräten.

6. Benachrichtigungen (optional)

Tautulli → Settings → Notification Agents. Verfügbar: E-Mail, Telegram, Ntfy, Pushoverneuem Gerät einrichten.

Fehlerbehebung

⚠️ "Server not found" bei Verify

Prüfen: (1) Container-Name korrekt — docker ps zeigt den genauen Namen, (2) Beide Container in tunnel-net — prüfen mit docker network inspect tunnel-net, (3) Plex läuft — Logs in Portainer prüfen.

⚠️ Token funktioniert nicht / "Unauthorized"

Token möglicherweise abgelaufen oder falsch kopiert. Schritt 3 wiederholen, View XML neu öffnen und Token aus der URL kopieren. Auf Leerzeichen am Anfang/Ende achten.

⚠️ History wird nicht aufgezeichnet

In Plex: Settings → Troubleshooting → Enable Plex Media Server Logging aktivieren. Auch prüfen: Settings → Network → Enable local network discovery.

⚠️ Geräte als "Unknown" angezeigt

GeoIP-Datenbank muss noch heruntergeladen werden. 5-10 Minuten warten, Container neustarten. Settings → GeoLite2 Database → Update klicken.

Homelab · Media GUIDE April 20, 2026 · 8 min read

Tautulli — installation and Plex connection

Complete guide: Docker Compose stack, Docker network for Plex communication, retrieving the Plex API key and Setup Wizard step by step.

If you read my Tautulli article, you know why you want this. Here is the complete walkthrough from installation to a working Plex connection.

What you need

Prerequisites

Plex running in Docker — container named PlexHW (or you know its container name). Docker network tunnel-net from the Cloudflare Tunnel guide — or you create a new one. Portainer installed.

1. Create directory

mkdir -p /volume1/docker/tautulli

mkdir -p ~/docker/tautulli

Create in Explorer:
C:\docker\tautulli

2. Docker Compose stack

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - /volume1/docker/tautulli:/config:rw
    environment:
      TZ: Europe/London
      PUID: 1026          # CHANGE TO YOUR UID
      PGID: 100           # CHANGE TO YOUR GID
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - ~/docker/tautulli:/config:rw
    environment:
      TZ: Europe/London
      PUID: 1000
      PGID: 1000
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

services:
  tautulli:
    image: ghcr.io/tautulli/tautulli:latest
    container_name: tautulli
    volumes:
      - C:/docker/tautulli:/config:rw
    environment:
      TZ: Europe/London
    ports:
      - 8181:8181
    networks:
      - tunnel-net
    restart: unless-stopped

networks:
  tunnel-net:
    external: true

⚠️ Why tunnel-net

Tautulli and Plex must be in the same Docker network to communicate by container name. If tunnel-net does not exist: docker network create tunnel-net then connect Plex: docker network connect tunnel-net PlexHW.

3. Get Plex API key

Step 1 — Open Plex in browser and start any video in your library.

Step 2 — Click the three dots (⋮) on the video → Get Info → in the dialog click View XML.

Step 3 — In the browser URL find the parameter X-Plex-Token=. The value after the equals sign is your API token — copy it.

Alternative — via Plex settings

Log into plex.tv → click avatar top right → Account Settings. The browser URL contains token=XXXXX — the token is the value after token=.

4. Setup Wizard — connect to Plex

Open http://192.168.1.100:8181. Tautulli launches the Setup Wizard.

Plex Host: PlexHW — container name, not IP address!
Port: 32400
Plex Token: paste token from step 3
Click Verify — green "Server found" should appear

⚠️ PlexHW not localhost

Always use the container name in the Plex Host field — not localhost, not an IP address. localhost would mean the Tautulli container itself. Container names resolve through Docker DNS — but only when both containers are in the same network (tunnel-net).

5. Dashboard overview

What is where

Activity — live streams with device, codec, Direct Play/Transcode and CPU load.

History — complete streaming history, filterable by user, content or date.

Statistics — most popular content, most active users, daily/weekly stats and peak hours.

Users — per-user detail with history, favourite content and devices used.

6. Notifications (optional)

Tautulli → Settings → Notification Agents. Available: Email, Telegram, Ntfy, Pushovernew device notification.

Troubleshooting

⚠️ "Server not found" on Verify

Check: (1) container name correct — docker ps shows exact name, (2) both containers in tunnel-net — verify with docker network inspect tunnel-net, (3) Plex is running — check logs in Portainer.

⚠️ Token not working / "Unauthorized"

Token may have expired or been copied incorrectly. Repeat step 3 — open View XML again and copy the token fresh from the URL. Watch for spaces at the start or end.

⚠️ History not being recorded

In Plex: Settings → Troubleshooting → Enable Plex Media Server Logging. Also check: Settings → Network → Enable local network discovery.

⚠️ Devices showing as "Unknown"

GeoIP database needs to download. Wait 5-10 minutes after install, restart the container. Settings → GeoLite2 Database → Update.

⚠️ Tautulli running but Plex streams not showing

Check that the Plex token belongs to the server admin account. Shared user tokens do not work — use the token from the server owner account.