What it is
Tautulli is a monitoring layer on top of Plex. It polls Plex's API, records every playback session, and gives me a UI for browsing watch history, top content, top users, and live activity. Sits in the same stack as Plex on the media LXC.
Why I run it
Plex's own activity view is fine for "what's playing right now," but it doesn't remember anything. Tautulli does, and it does it with enough resolution that I can answer questions like "what did I actually watch this year," "which user transcodes the most," and "did anyone notice when the server was slow last Tuesday."
The other reason is operational: Tautulli's API exposes a stable feed of "active streams" and "library sizes" that my homepage dashboard reads. I get a glanceable count of what's happening on the media server without opening Plex.
How I use it
Mostly passive. I look at the dashboard occasionally to see what's been watched, but the real value is the homepage widget — a quick "X streams active" badge on my dashboard that tells me whether anything is going on with the media server right now. The notification engine is plumbed but I don't use it heavily; I have other channels for "the server is unhappy."
Setup notes
- Host: the media LXC, alongside Plex.
- Plex connection: auto-discovered via the Plex token. Same token Plex uses; rotating the token means updating it in Tautulli's settings too.
- Reverse proxy: yes.
- Backups: PBS captures the LXC. Tautulli also auto-backs up its SQLite DB into the config directory on a schedule.
- Update cadence: manual.
Runbook
- Healthy looks like: dashboard loads, live activity reflects current Plex sessions, API call from the homepage widget returns a fresh count.
- Homepage widget shows "API Error": the API key in the homepage environment is stale. Check Tautulli → Settings → Web Interface → API for the current value.
- Tautulli isn't logging new sessions: Settings → Plex Media Server → Test Connection. Most common cause is a rotated Plex token that wasn't updated here.
- Where logs live: Settings → Logs in the Tautulli UI;
docker logs tautullion the host.