Tautulli

Monitoring and statistics tracker for Plex Media Server

Tautulli is a third-party application that runs alongside your Plex Media Server to monitor activity and track various statistics. It provides detailed insights into what has been watched, who watched it, when and where they watched it, and how it was watched. With beautiful graphs, user analytics, notification capabilities, and extensive customization, Tautulli is the essential companion app for Plex administrators. QuickBox Pro installs Tautulli from the GitHub repository with Python 3.13, per-user service configuration, and auto-incremented ports.

Installation

Basic Installation

Install Tautulli for a specific user:

qb install tautulli -u username

CLI Commands

Accessing Tautulli

After installation, access Tautulli at:

https://your-server-ip/tautulli

First-Time Setup:

1. Complete the setup wizard
2. Connect to your Plex Media Server
3. Configure notification preferences
4. Set up user accounts and permissions

Initial Configuration

1. Connect to Plex Media Server

On first access, connect Tautulli to Plex:

1. Click Next on the welcome screen
2. Select Sign in with Plex or Manual Configuration
3. If signing in with Plex:
   • Sign in with your Plex account
   • Authorize Tautulli to access your server
   • Select your Plex Media Server from the list
4. If using manual configuration:
   • Enter Plex IP: 127.0.0.1 (localhost)
   • Enter Plex Port: 32400
   • Enter Plex Token: Get from https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/
5. Click Verify to test connection
6. Click Next to continue

2. Configure Activity Logging

Set up activity tracking:

1. Go to Settings → Activity Logging
2. Configure logging options:
   • Log played: Enable to track all playback
   • Log paused: Track pause events
   • Log stopped: Track stop events
   • Log resumed: Track resume after pause
3. Set Logging Level:
   • Debug for detailed logging (troubleshooting)
   • Info for standard logging (recommended)
   • Warning for errors and warnings only
4. Save settings

3. Set Up Notifications (Optional)

Configure notifications for Plex events:

1. Go to Settings → Notification Agents
2. Add notification agent (examples):
   • Email - Email notifications
   • Discord - Discord webhooks
   • Slack - Slack channel notifications
   • Webhook - Custom webhook endpoints
3. Configure triggers:
   • Playback Start - When media begins playing
   • Playback Stop - When media stops
   • Watched - When media is marked as watched
   • Recently Added - New content added to library
4. Customize notification templates with variables
5. Test and save

Service Management

Tautulli runs as a systemd service per user.

systemctl status tautulli     # Check status
systemctl restart tautulli    # Restart service
journalctl -u tautulli -f     # View live logs
systemctl enable tautulli     # Start on boot (already enabled)
systemctl disable tautulli    # Prevent auto-start

Troubleshooting

Tautulli Won’t Start

journalctl -u tautulli -f

Check Python installation:

python3.13 --version
# Should show Python 3.13.x
 
# Or on Debian 13
python3 --version

Cannot Connect to Plex Server

No Activity Showing

# Verify activity logging is enabled
# Settings → Activity Logging → Enable logging
 
# Check Plex is generating activity
# Open Plex and play something
 
# Verify Tautulli can read Plex logs
journalctl -u tautulli -f | grep -i "plex"
 
# Refresh activity page in Tautulli
# Activity → Home → Refresh button

Notifications Not Working

# Test notification agent
# Settings → Notification Agents → [Agent] → Test
 
# Check notification triggers are configured
# Settings → Notification Agents → [Agent] → Triggers
 
# Verify webhook URL or credentials are correct
 
# Check logs for notification errors
journalctl -u tautulli -f | grep -i "notif"

Permission Issues

sudo chown -R username:username /opt/username/Tautulli
sudo chown -R username:username /home/username/.config/Tautulli
systemctl restart tautulli

Configuration Reset

# Backup current configuration
cp -r ~/.config/Tautulli ~/.config/Tautulli.backup
 
# Stop service
systemctl stop tautulli
 
# Remove configuration (will be regenerated)
rm ~/.config/Tautulli/config.ini
 
# Restart service
systemctl start tautulli

Best Practices

Use Cases

Server Monitoring

• Track all Plex activity in real-time with live stream information
• Monitor bandwidth usage and identify transcoding bottlenecks
• View server health and resource utilization
• Get alerts for server issues or playback errors

User Analytics

• Analyze viewing habits per user (most watched, favorite genres)
• Track user activity patterns (peak hours, device usage)
• Identify inactive users or heavy streamers
• Generate watch reports for billing or quota management

Content Insights

• Discover most popular movies, TV shows, and music
• Track recently added content and library growth
• Identify unwatched content for removal decisions
• Analyze genre popularity and viewing trends

Related Applications

Additional Resources