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


  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 27322 --nolaunch

  4. Access Tautulli at http://server.whatbox.ca:27322 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. Remove .pyc files: find . -name '*.pyc' -delete

  5. Start Tautulli: screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 27322 --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 -fx "/usr/lib/python-exec/python3.7/python3 /home/user/Tautulli/Tautulli.py -p 27322 --nolaunch" > /dev/null
         echo "Tautulli is running."
         echo "Tautulli is not running, starting Tautulli"
         screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 27322 --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.