Skip to main content

04-tautulli.md

kstack: book: Centerpoint Home Lab chapter: Media & Entertainment page: Tautulli tags: [tautulli, plex, monitoring, analytics]

Overview

Tautulli is the monitoring and analytics companion for Plex Media Server. It tracks play history, user activity, and library statistics, and can send notifications (email, Telegram, etc.) on media events such as new content additions, playback starts, or user logins.

Access

Type URL Notes
Internal https://tautulli.home.local LAN access via Step-CA TLS

No external route — LAN and Tailscale access only.

Configuration

Image: lscr.io/linuxserver/tautulli:latest Compose project: Standalone (managed via Portainer)

Traefik Labels

traefik.enable: "true"
traefik.http.routers.tautulli.rule: Host(`tautulli.home.local`)
traefik.http.routers.tautulli.entrypoints: websecure
traefik.http.routers.tautulli.tls.certresolver: step-ca
traefik.http.services.tautulli.loadbalancer.server.port: 8181

Environment Variables

Variable Value Purpose
PUID 1000 User ID
PGID 1000 Group ID
TZ America/Toronto Timezone

Volumes / Bind Mounts

Host Path Container Path Purpose
/home/jeeves/docker/Tautulli/local_tautulli /config Tautulli database and configuration

Networks

Network Purpose
traefik-net Exposes Tautulli UI; also reaches Plex container

Dependencies

  • Plex Media Server — Tautulli connects to the Plex API to retrieve playback data. Configure the Plex connection in Tautulli Settings → Plex Media Server using the container hostname plex and port 32400.

Notes / Gotchas

  • Tautulli's database (tautulli.db) contains full play history. Back it up before upgrades.
  • Notification agents (Telegram, email, etc.) and their credentials are stored in the Tautulli database. If the /config bind mount is lost, all notification integrations must be reconfigured.

Last Updated: 2026-06-16