Wiki > Tautulli
Tautulli (formerly PlexPy) is a python based web application for monitoring, analytics and notifications for Plex. Tautulli runs on its own port; 27658 has been automatically generated for you, but you may choose another 5 digit port between 10000 and 32767.
Installation
-
Clone the repository:
git clone https://github.com/Tautulli/Tautulli.git
-
Remove a broken Python module:
rm -r ~/Tautulli/lib/jaraco/text/
-
Start Tautulli:
screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 27658 --nolaunch
-
Access Tautulli at
http://server.whatbox.ca:27658
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, useserver.whatbox.ca
as your Plex hostname and the port listed in Plex's settings for your server underRemote Access
.
Manual update
-
Terminate existing Tautulli processes:
pkill -f Tautulli.py
-
Change to the Tautulli directory:
cd ~/Tautulli
-
Update Tautulli with git:
git pull
-
Remove
.pyc
files:find . -name '*.pyc' -delete
-
Remove a broken Python module:
rm -r ~/Tautulli/lib/jaraco/text/
-
Start Tautulli:
screen -dmS tautulli python3 ~/Tautulli/Tautulli.py -p 27658 --nolaunch
Automatically Restart
Below are steps to take to have your Tautulli instance automatically restart if it crashes, or if the server is rebooted.
-
Make a file to be used for the script.
touch ~/tautulli_restart.cron
-
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 27658 --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 27658 --nolaunch fi exit
-
Save the file with Ctrl+x and the "y" and hit Enter to accept overwriting.
-
Make the script executable.
chmod +x ~/tautulli_restart.cron
-
Open your crontab.
EDITOR=nano crontab -e
-
Enter the following text
@reboot /home/user/tautulli_restart.cron >/dev/null 2>&1 */5 * * * * /home/user/tautulli_restart.cron >/dev/null 2>&1
-
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 27658 --nolaunch
and read the error output. It will tell you what problems Tautulli is having when trying to launch.