Tautulli Setup Guide: Monitor Your Plex Server Like a Pro

If you share your Plex server with more than two people, you need Tautulli. It’s a free, open-source monitoring tool that shows you who’s watching what, whether streams are transcoding or direct playing, how much bandwidth each user consumes, and what your most-watched content is. Plex’s built-in dashboard shows current streams, but Tautulli gives you history, analytics, and notifications. Here’s how to set it up properly.

Installation Options

Tautulli runs as a lightweight Python web app. Three installation paths:

Docker (Recommended)

The cleanest option. One command:

docker run -d \
  --name tautulli \
  --restart unless-stopped \
  -p 8181:8181 \
  -v /path/to/tautulli/config:/config \
  tautulli/tautulli

Point your browser at http://server-ip:8181 and follow the setup wizard. You’ll need your Plex server URL and a Plex token (Tautulli walks you through getting one).

Bare Metal (Linux/Windows/Mac)

Clone the repo and run it directly. Useful if you don’t use Docker:

git clone https://github.com/Tautulli/Tautulli.git
cd Tautulli
python Tautulli.py

Create a systemd service (Linux) or a scheduled task (Windows) to start it on boot.

Synology/QNAP Package

Third-party packages exist for NAS platforms, but they tend to lag behind the official release. If you run Plex on a NAS, Docker (via Container Manager on Synology, Container Station on QNAP) is the more reliable path.

Essential Dashboard Views

Once connected to Plex, Tautulli populates several views:

• Activity: Real-time view of all current streams. Shows user, content, quality, player, whether it’s direct playing or transcoding, current bitrate, and buffer health
• History: Every stream ever played on your server. Searchable by user, content, date, and play type. Essential for answering “who watched my server to death at 2 AM?”
• Users: Per-user stats — total plays, last seen, most-watched content, average quality, and whether they tend to transcode or direct play
• Libraries: Which libraries get the most usage, least-watched content (candidates for cleanup), and storage efficiency
• Graphs: Play count over time, concurrent streams over time, bandwidth by user, transcode vs. direct play ratio. The concurrent streams graph is the most actionable — it shows your peak load and when it happens

Setting Up Notifications

Tautulli can send notifications via Discord, Slack, Telegram, email, Pushover, and dozens of other services. The most useful notification triggers:

• Playback start/stop: “John started watching Breaking Bad S01E01 (Transcode: 1080p → 720p)” — know instantly when someone is hammering your server with transcoding
• Buffer warnings: Tautulli detects buffer events and can alert you when a user is experiencing playback issues
• Concurrent stream threshold: “5 concurrent streams active” — useful if your server or upload bandwidth has a practical limit
• Plex server down: Tautulli monitors Plex availability and can ping you if the server stops responding
• New content added: Notify your users (via a shared Discord channel, for example) when new movies or episodes hit the library

Advanced: Newsletter and User Management

Tautulli has a built-in newsletter feature that sends a weekly or monthly email to your users with recently added content, complete with poster art and metadata. It’s a surprisingly effective way to drive engagement — people stream more when they know what’s new.

On the management side, Tautulli can track inactive users (no streams in 30/60/90 days) and even automatically terminate streams that match certain criteria (e.g., paused for more than 30 minutes, preventing “phantom transcodes” from eating GPU resources).

What Tautulli Can’t Do

Tautulli monitors Plex; it doesn’t control it. It can’t:

• Add or remove libraries
• Manage user permissions (use Plex’s built-in user sharing for that)
• Control transcoding quality or force direct play
• Replace Plex’s dashboard for server configuration

Think of it as a read-only analytics layer on top of Plex. It watches everything, reports everything, and lets you set up automations based on what it sees — but the configuration of Plex itself stays in Plex.

Using Tautulli with PlexBeam

If you use PlexBeam for remote GPU offloading, Tautulli’s transcode monitoring becomes even more valuable. You can see exactly which streams are being handled by your local server vs. offloaded to a remote GPU, track the latency added by remote transcoding, and verify that your local server’s CPU is actually being relieved of transcode workload.