Skip to content


timekills edited this page Mar 26, 2019 · 64 revisions
WANT TO HELP? CLICK THE ★ (STAR LOGO) in the Upper-Right!

  • 📂 [Click Here] - Google G-Suite (Unlimited Hard Drive Space & Storage)
  • 📂 [Click Here] - Top Performance NewsHost! - Blitz Members Receive a 58% Discount

Reference Shortcut - | Discord ( !tautulli )

_**Table of Contents**_
  1. Intro
  2. PG YouTube
  3. Access Information
  4. Initial Configuration
  5. Helpful scripts
    1. Stop transcoding by rule
  6. Summary

1. Intro

Tautulli is a great way to gather information on how your Plex Server is being utilized, what users are playing, and enabling certain notifications and access controls for your users. With Plex's new ability to graph user bandwidth and info, Tautulli may not require deployment unless specific capabilities enhance your server. Tautulli for legacy users was known as PlexPy in the past.

2. PG YouTube


3. Access Information

Protocol Address Notes
traefik** tautulli:8181 Only for Internal App-to-App Communication
https Traefik must be Deployed; Remote Servers
http Poor Security Practice - Stop with PG Port Guard
http ipv4:8181 Ideal Only for Local Servers

Additional Subdomains:

4. Initial Configuration

Default User: plex Default Pass: guide Click Sign In

Next, the following image should load as seen below. Click Next

  1. Sign into Plex! Click Sign in with Plex
  2. When done, Click Next

  1. Select a Server
  2. Select a Port (leave this alone; unless required to change)
  3. Click Verify to ensure that Tautulli connects to the Plex Server
  4. When done, Click Next

  1. Click Next

  1. Click Next

  1. Click Next

That's it!

5. Helpful scripts

Prevent Transcoding (at all, or in specific cases)

You can use Tautulli to automatically prevent transcoding, either by resolution, by bit depth (i.e. stop HDR/10-bit files from being transcoded) or just at all. Why would you want this? If your server isn't powerful enough to do transcoding at all, but the users don't know enough to force direct play, then this will stop the stream and provide a pop-up message explaining the reason. Maybe your server can do transcoding, but not for 4K. Or maybe it can even do 4K, but Plex right now can't transcode HDR to HDR. So if you have a 4K or even 1080P video in HDR/10bit color and it has to transcode, it will only be in SDR. The tonemapping in Plex (and Emby/Jellyfin) - for now - is based on an FFMPG version that doesn't support HDR->HDR transcode, so it looks all washed out.

  • Confirm in Portainer that the host directory "/opt/appdata/tautulli/scripts" is mounted to "/scripts" in the Docker container (that is the default setting, so it should be already.)
  • From the host (SSH) enter the following code (slightly modified from
    • cd /opt/appdata/tautulli/scripts
    • sudo curl -O
    • sudo chown root:root #not really necessary if running as root
    • sudo chmod a+x
      • Note that the file size is actually ~20K, not 9K as listed on the github page.

Follow the instructions below:

  • Configure Tautulli Notification Agent
    • Enter Tautulli settings and find the Notification Agents link on the left side menu.
    • Click Add a new notification agent and scroll down to Script in the selection dialog.
    • Configuration panel
      • Enter /scripts in the script folder and exit the text input field.
      • Select the script named ./ in the Script File drop-down.
      • Enter Terminate 4K transcodes or something of your own choice in the description field.
    • Triggers panel
      • Put a checkmark in Playback Start and Transcode Decision Change
    • Conditions panel
      • Condition {1}: Video Decision - is - transcode (you'll have to manually type in the transcode variable)
      • Add a new Condition (use the + symbol)
      • Condition {2}: Video Resolution - is - 4K (if you want it to prevent ANY transcoding of 4K video)
        • (Alternatively, if you only want to stop HDR/10 bit transcode, since even if your CPU/GPU can support 4K transcoding it will always be transcoded to SDR and look like garbage) : Video Bit Depth - is - 10
    • Arguments panel
      • Under Playback Start enter the following: --jbop stream --username {username} --sessionId {session_id} --killMessage 'Transcoding is not allowed from the 4K libraries.'
        • Note the "killMessage" part can be whatever text you want to pop-up when the transcode is stopped. For example, I changed mine to --jbop stream --username {username} --sessionId {session_id} --killMessage 'This is an HDR/10-bit color video. Transcoding will make the colors look washed out and bad. Please set your player to play at the original resolution.'
      • Under Transcode Decision Change enter the following: --jbop stream --username {username} --sessionId {session_id} --killMessage 'Transcoding is not allowed from the 4K libraries.'
    • Click the Save button to save the new notification agent. You can test the agent by attempting to play a 4K movie through the Plex web app and downgrade the quality to 2Mbit (or whatever will break the rule you set). It will be transcoding for about 5-10 seconds, after which you should get the stream kill message.

This is an example of the pop-up your users will see if Tautulli stops the transcode:

6. Summary

Tautulli is simple to use, but has many options. If you require more information, please visit the Tautulli Wiki

Useful Starter Links

  1. Introduction
  2. Blitz YouTube Channel
  3. G-Suite Signup
  4. Recommended NewsHosts

Prior Planning 101

  1. Recommended Pre-Reading
  2. Server - Storage Planning
  3. Usenet or BitTorrent
  4. PG Editions
  5. PGBlitz Repos
  6. Common Issues

Deploy & Config

  1. SSH Server Access
  2. Create a SUDO User
  3. Install PGBlitz
  4. WatchTower
  5. Remote Path Mappings

Data Transport
  1. PG Clone
    1. Google OAuth Keys
    2. PG Move
    3. PG Blitz
    4. 2nd HD Option

Key Components

  1. Traefik
  2. Port Guard
  3. PG Shield
  4. PG Press
  5. Google Cloud - GCE
    1. Automated setup
  6. Hetzner Cloud
  7. PG Fork
  8. Extra PG Commands

Blitz App Info

  1. Accessing PG Apps
  2. App Port Scheme
  3. Plex to AutoScan

Tools & Services

Core Apps [Expand]
  1. Emby
  2. Jackett
  3. Jellyfin
  4. LazyLibrarian
  5. Lidarr
  6. Netdata
  7. NZBGet
  8. Ombi
  9. Plex
  10. Portainer
  11. qBittorrent
  12. Radarr
  13. RuTorrent
  15. Sonarr
  16. Tautulli
Community Apps [Expand]
  1. AirSonic
  2. AllTube
  3. Bazarr
  4. Beets
  5. Bitwarden
  6. BookSonic
  7. cAdvisor
  8. Cloud Commander
  9. DDClient
  10. Deezloaderremix
  11. Deluge
  12. DelugeVPN
  13. Duplicati
  14. EmbyStats
  15. FlexGet
  16. Gazee
  17. Gitea
  18. Handbrake
  19. Headphones
  20. Heimdall
  21. HomeAssistant
  22. HTPCManager
  23. JDownloader2
  24. jd2-openvpn
  25. Kitana
  26. Logarr
  27. MakeMKV
  28. MariaDB
  29. McMyadmin
  30. MEDUSA
  31. Mellow
  32. Monitorr
  33. Muximux
  34. Mylar
  35. NextCloud
  36. NowShowing
  37. NZBHydra2
  38. NZBThrottle
  39. Organizr
  40. pyLoad
  41. Radarr4k
  42. Resilio
  43. rflood-openvpn
  44. rutorrent-openvpn
  45. ShareSite
  46. Shoko Anime Server
  47. SpeedTest
  48. SyncLounge
  49. Syncthing
  50. The Lounge
  51. Transmission
  52. Trakt.or
  53. Ubooquity
  54. x TeVe
  55. Zammad

Misc Info & Articles

  1. Change Server Time
  2. Fail2Ban
  3. Custom Containers
  1. Scripting Area
    1. Auto Upload for Sonarr and Lidarr
    2. Auto Delete Log
    3. Plex Plugin DB Backup
    4. Plex fast BACKUP
Clone this wiki locally
You can’t perform that action at this time.