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
plexand port32400.
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
/configbind mount is lost, all notification integrations must be reconfigured.
Last Updated: 2026-06-16