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; 11904 has been automatically generated for you, but you may choose another 5 digit port between 10000 and 65535.

Installation

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. Start Tautulli: screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 11904 --nolaunch

  4. Access Tautulli at http://server.whatbox.ca:11904 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. Start Tautulli: screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 11904 --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

     #!/bin/bash
     if pgrep -fx "/usr/lib/python-exec/python3.8/python3 /home/user/Tautulli/Tautulli.py -p 11904 --nolaunch" > /dev/null
     then
         echo "Tautulli is running."
     else 
         echo "Tautulli is not running, starting Tautulli"
         screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 11904 --nolaunch
     fi
     exit
    
  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.