Tautulli

Tautulli is a Python-based monitoring, analytics and notifications tool for Plex Media Server.

You'll need to execute some commands via SSH to use this software. There is a separate guide on how to connect to your slot via SSH. Commands are kept as simple as possible and in most cases will simply need to be copied and pasted into the terminal window (then executed by pressing the Enter key).

Table of contents

Installation

Install Tautulli by logging in via SSH, then copying and pasting the following script:

wget -O ~/install.tautulli.sh https://bitbucket.org/feralio/wiki/raw/HEAD/src/wiki/software/tautulli.install.sh && bash ~/install.tautulli.sh

This script will output a success message alongside the URL to access Tautulli. Tautulli will take about five minutes to start up and then present a "Tautulli Setup" wizard.

You must complete this wizard immediately to secure Tautulli.

Starting, stopping and restarting

This section covers the Tautulli process—starting, stopping and restarting it. It also covers checking if the main process is running, in case that becomes necessary.

start
You cannot start Tautulli manually. Wait five minutes for it to auto-restart.
check running
pgrep -af Tautulli
stop
pkill -fe Tautulli
kill (force stop)
pkill -9 -fe Tautulli
restart
pkill -fe Tautulli Then wait five minutes for it to auto-restart.

Updating Tautulli

The executable and associated files to run Tautulli can be found under ~/.config/feral/ns/containers/docs-tautulli/app. If this folder is missing the latest version will be downloaded and Tautulli will be restarted.

You can use an SFTP / FTP client to delete the folder. Or alternatively you can run the SSH command: rm -r ~/.config/feral/ns/containers/docs-tautulli/app

If you find this folder doesn't exist but Tautulli is definitely running then you likely installed Tautulli using a previous version of this guide. To address this, first ensure Tautulli's auto-restart is disabled (usually done via ~/.cronscript.sh) and then run the install script to get the newer set up.

Uninstall

The following SSH commands will uninstall Tautulli from your slot. You do not need to run them if reinstalling.

rm -rf ~/.config/feral/ns/containers/docs-tautulli ~/install.tautulli.sh ~/.nginx/conf.d/000-default-server.d/tautulli.conf
/usr/sbin/nginx -s reload -c ~/.nginx/nginx.conf 2>/dev/null
pkill -9 -fe Tautulli
echo Uninstalled.