Tautulli

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

Installation

  1. SSH to your slot

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

  3. Start Tautulli: screen -dmS tautulli ~/Tautulli/Tautulli.py -p 65399

  4. Access Tautulli at http://server.whatbox.ca:65399 and follow the setup wizard's instructions. Use server.whatbox.ca as your Plex hostname and the port you chose during Plex setup. You can find this port in Plex's settings under Server -> 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. Start Tautulli: screen -dmS tautulli ~/Tautulli/Tautulli.py -p 65399

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/python2.7/python /home/user/Tautulli/Tautulli.py -p 65399 --nolaunch" > /dev/null
     then
         echo "Tautulli is running."
     else 
         echo "Tautulli is not running, starting Tautulli"
         screen -dmS tautulli ~/Tautulli/Tautulli.py -p 65399 --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.

Downgrading to PlexPy 1.4.25 (Optional)

The legacy guide found here may have more information available than the below.

  1. Backup your database! Go to the PlexPy Settings > General tab > Backup Database (V1) or Tautulli Settings > Import & Backups > Backup Database

  2. Terminate existing PlexPy processes: pkill -f PlexPy.py

  3. Clone the repository: git -b dev clone https://github.com/Tautulli/Tautulli.git plexpy

  4. Start PlexPy: screen -dmS plexpy ~/plexpy/PlexPy.py -p 65399

  5. Make a file to be used for the script. touch ~/plexpy_restart.cron

  6. Edit the file and enter the text below. nano -w ~/plexpy_restart.cron

     #!/bin/bash
     if pgrep -fx "/usr/lib/python-exec/python2.7/python /home/user/plexpy/PlexPy.py -p 65399" > /dev/null
     then
         echo "PlexPy is running."
     else 
         echo "PlexPy is not running, starting PlexPy"
         screen -dmS plexpy ~/plexpy/PlexPy.py -p 65399
     fi
     exit
    
  7. Save the file with Ctrl+x and the "y" and Enter to accept overwriting.

  8. Make the script executable. chmod +x ~/plexpy_restart.cron

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

  10. Enter the following text

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