Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > Tautulli

Tautulli (formerly PlexPy) is a python based web application for monitoring, analytics and notifications for Plex. Tautulli runs on its own port; 29722 has been automatically generated for you, but you may choose another 5 digit port between 10000 and 32767.


Custom installations of Tautulli do not have authentication enabled by default! You must follow all of the installation instructions or Tautulli will be publicly accessible.
  1. SSH to your slot

  2. Clone the repository: git clone https://github.com/Tautulli/Tautulli.git

  3. Remove a broken Python module: rm -r ~/Tautulli/lib/jaraco/text/

  4. Start Tautulli: screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 29722 --nolaunch

  5. Access Tautulli at http://server.whatbox.ca:29722 and follow the setup wizard's instructions. You must fill out the "HTTP Username" and "HTTP Password" fields with a username and password you want to use to log into Tautulli.

    The setup wizard should show your Plex account's Plex servers. Make sure Use SSL is checked. If your Plex server is not showing, use server.whatbox.ca as your Plex hostname and the port listed in Plex's settings for your server under Remote Access.

Manual update

  1. Terminate existing Tautulli processes: pkill -f Tautulli.py

  2. Change to the Tautulli directory: cd ~/Tautulli

  3. Update Tautulli with git: git pull

  4. Remove .pyc files: find . -name '*.pyc' -delete

  5. Remove a broken Python module: rm -r ~/Tautulli/lib/jaraco/text/

  6. Start Tautulli: screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 29722 --nolaunch

Automatically Restart

Below are steps to take to have your Tautulli instance automatically restart if it crashes, or if the server is rebooted.

  1. Make a file to be used for the script. touch ~/tautulli_restart.cron

  2. Edit the file and enter the text below. nano -w ~/tautulli_restart.cron

     if pgrep -f "python3 /home/user/Tautulli/Tautulli.py -p 29722 --nolaunch" > /dev/null
         echo "Tautulli is running."
         echo "Tautulli is not running, starting Tautulli"
         if [[ -d ~/Tautulli/lib/jaraco/text/ ]]
             rm -r ~/Tautulli/lib/jaraco/text/
         screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 29722 --nolaunch
  3. Save the file with Ctrl+x and the "y" and hit Enter to accept overwriting.

  4. Make the script executable. chmod +x ~/tautulli_restart.cron

  5. Open your crontab. EDITOR=nano crontab -e

  6. Enter the following text

     @reboot /home/user/tautulli_restart.cron >/dev/null 2>&1
     */5 * * * * /home/user/tautulli_restart.cron >/dev/null 2>&1
  7. Save the crontab with Ctrl+x and the "y" and Enter to accept overwriting.


If Tautulli is not starting correctly, run Tautulli outside of screen with python3 ~/Tautulli/Tautulli.py -p 29722 --nolaunch and read the error output. It will tell you what problems Tautulli is having when trying to launch.