Wiki > Tautulli

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

Installation

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

5. Access Tautulli at http://server.whatbox.ca:17880 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 17880 --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 -f "python3 /home/user/Tautulli/Tautulli.py -p 17880 --nolaunch" > /dev/null
    then
        echo "Tautulli is running."
    else 
        echo "Tautulli is not running, starting Tautulli"
        if [[ -d ~/Tautulli/lib/jaraco/text/ ]]
        then
            rm -r ~/Tautulli/lib/jaraco/text/
        fi
        screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 17880 --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.

Issues

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