Frequently Asked Questions (FAQ)
Last updated
Was this helpful?
Last updated
Was this helpful?
If you can't find a solution here, please ask on , or the . Don't post questions on the GitHub issues tracker.
A: Most datatable warnings can be solved by doing a force refresh in your browser (CTRL+F5 or OPTION+Reload on Mac/Safari). If that doesn't work, try clearing your browser's cache.
A: Follow these steps to get back in: 1. Shut down Tautulli so your changes will apply. 2. Open the Tautulli config.ini file with your preferred text editor. 3. Search for http_username and http_password and the values after the equal signs are the username and password. You can also delete both lines from the file to disable authentication.
Note: If your password is encrypted in the config file, you will have to delete the entire line to disable authentication and reset your password in the Tautulli settings.
A: Shut down Tautulli and open the Tautulli config.ini file with your preferred text editor, search for the lines that begin with http_host, http_port, and http_root and remove the entire line. You should also remove the line for enable_https from the file. After you have removed these lines from config.ini, go ahead and start Tautulli. It will listen on the default IP address and port (http://localhost:8181).
A: When you try you Tautulli and you get the message "A newer version (vX.Y.ZZ) is available", but updating doesn't actually update Tautulli there are two ways you can solve the problem, depending on how you installed Tautulli.
Git based installation
If you installed Tautulli by cloning the git repository, it's possible your local git repository has gotten out of sync in a manner that Tautulli can't automatically update from.
If you are running Tautulli v2.2.0 or newer you can have Tautulli attempt to fix this itself by going to Settings -> General -> [Show Advanced] -> Repair Git Install -> Reset. This will attempt to automatically run the commands described below for you, cleaning up some common issues.
If you are running an older version of Tautulli, or the above didn't work, you will need to manually fix this. First Shutdown Tautulli, then run the following commands from the command line/shell in the Tautulli folder.
ZIP install
Note: You should be replacing the existing files, if you are prompted about this please select to replace the files!
If needed, ensure the permissions are correct
For example: sudo chown -R tautulli:tautulli /path/to/Tautulli
Start Tautulli
A: See the answer to the previous question.
A: No, not necessarily. It means that you requested data that is not available, for example when you view the profile of a user who hasn't watched anything yet or view synced items when there is nothing synced.
A: This usually happens when you try to reinstall or switch your Plex Media Server. You can visit the following URL to remove all libraries not associated with the current Plex server connected to Tautulli.
If the libraries are duplicated on the homepage, toggle the Library Statistic cards under Settings > Homepage and click Save.
A: WARNING: Before you follow any of these methods make sure you have enabled authentication in Tautulli under Settings -> Web Interface by setting a HTTP Username and Password. If you load Tautulli in an Incognito window you should get a login prompt!
The more advanced and most preferred method (and more secure if you use SSL) is to set up a web server with NGINX/Apache, and use a reverse proxy to access Tautulli. You can lookup many guides on the internet to find out how to do this.
The most secure method, but also the most inconvenient, is to set up a VPN tunnel to your home server, then you can access Tautulli as if it is on a local network via http://LOCAL-IP-ADDRESS:8181.
A: Tautulli uses CherryPy as it's web server, and it includes support for reverse proxies. You must ensure that your proxy web server (e.g. NGINX or Apache) is sending the standard X- headers to CherryPy. For NGINX, the configuration would look like this:
If you have SSL enabled on your webserver (e.g. Internet --> https://nginx --> http://tautulli), make sure HTTP Proxy is checked under Settings > Show Advanced button > Web Interface. Then ensure that your proxy web server is also including these two SSL specific X- headers:
As an alternative, the following configuration will automatically work for both HTTP and HTTPS.
Don't forget to clear your web browser's cache every time you update your web server configuration.
A: Yes, all you need to do is download a copy your tautulli.db database file and config.ini configuration file by clicking on the "Database File" and "Configuration File" links on the Settings > Help & Info page. Then after reinstalling and completing the setup wizard, go to the Settings > Import & Backup page to import the old tautulli.db database and config.ini configuration files. This will work between any OS.
A: If you have deleted a user or library in Tautulli and would like to bring them back the best method is to immediately restore a backup as the related history for these are removed when they are deleted. If you no longer have a backup containing the history, or don't want to bother with recovering it, you can simply tell Tautulli to allow them back in by "undeleting" them with the following instructions.
Undeleting a user
You will see a list of items, find the entry that corresponds to the user you want to undelete, the user_id is in the id="12345" part. So for example in this entry the user_id would be 8367478:
Once you have the ID you need to go to /undelete_user?user_id=<user_id> on your Tautulli instance. For example for the above ID on a Tautulli instance on the same machine you would go to:
If you are unable to find the user_id, you may try using the username (/undelete_user?username=<username>) or their email address (/undelete_user?username=<user's Plex email address>), but these are less accurate and may not work. Example usage of these for a Tautulli instance running on the same computer would be:
Undeleting a library
You will see a list of items, find the entry that corresponds to the library you want to undelete, the section_id is in the key="2" part. So for example in this entry the section_id would be 3:
Once you have the section ID you need to go to /undelete_library?section_id=<section_id> on your Tautulli instance. For example for the above ID on a Tautulli instance on the same machine you would go to:
If you are unable to find the section_id, you may try using the library name (/undelete_library?section_name=<section_name>), but this is less accurate and may not work. Example usage for a Tautulli instance running on the same computer would be:
A: You can import your PlexWatch/Plexivity history into Tautulli by going to Settings > Import & Backups.
A: You can view the Tautulli logs from the web interface by clicking on "View Logs" in the settings menu. Clicking on the "Download logs" button on this page will allow you to save a copy of the log file. The location of the log file is also listed on the Settings > Help & Info page.
If Tautulli is unable to start, then the log file is located in the following locations:
Git or zip based installation: <Tautulli-install-directory>/logs/tautulli.log
Windows exe installation: %LOCALAPPDATA%\Tautulli\logs\tautulli.log
macOS pkg installations: ~/Library/Application Support/Tautulli/logs/tautulli.log
A: Go into the Tautulli Settings > Plex Media Server and fetch a new Plex.tv token.
A: First check that you can access your server locally with SSL. Open your Tautulli settings, go to the Plex Media Server section and copy the "Plex Server URL" URL into a new browser tab to attempt to load your server's interface directly.
Otherwise, you may have to set secure connections to "Preferred" in your Plex server settings and uncheck the "Use SSL" box in the Tautulli settings. Tautulli will then connect to your Plex server directly without SSL using the address http://LOCAL-IP-ADDRESS:32400.
A: There are two ways to fix Tautulli when you get this message:
The Easy Way
The easiest way to fix this is to just restore an older version of the database from the backup directory. To do this:
Shutdown Tautulli if it is running.
Move or rename the current tautulli.db.
Copy the latest backups/tautulli.backup-YYYYMMDDHHMMSS.sched.db file to the main folder as tautulli.db.
Start Tautulli back up.
The Long Way
Backup your Tautulli database (tautulli.db) by making a copy and saving it somewhere safe.
Go to "File > Export > Database to SQL file..."
Click "OK" and save the .sql file on your computer.
Go to "File > Close Database".
Go to "File > Import > Database from SQL file..."
Select the .sql file you saved from step 4, and save the new file as tautulli.db. Do not overwrite your original file!
If you run into an error during the above step see the note below!
Save the changes to the database when prompted
(Optional) Go to the "Execute SQL" tab and run pragma integrity_check; and it should say "ok".
Go to "File > Close Database".
Replace your Tautulli database (tautulli.db) file with this new one.
Note: If you run into issues during step 9 above when building a new database from your exported SQL file the first thing to try would be a minimal export that only saves your history and settings. To do this: 1. Follow the steps above, however during step 5 instead of selecting all tables you will want to change that to only export the following tables:
mobile_devices
newsletters
notifiers
session_history
session_history_media_info
session_history_metadata
A: Tautulli does not require your Plex logs to function. You can add your Plex logs folder to Tautulli in order to use it as a convenient log viewer. If you are installing Tautulli in a Docker container or jail, then you will need to mount/share the Plex log folder into the Tautulli container. You must also specify the full path to the Plex logs folder (shortcuts will not work).
A: Your config.ini file is corrupted. Either delete the file (you will have to reconfigure your Tautulli settings) or try restoring a config file from the backups folder.
A: Only basic data is being collected, and it is not user identifiable. Here is a sample of the data being collected:
If you would like to opt-out of data collection, you can set system_analytics = 0 in the config.ini file. Tautulli must be shut down when editing the file.
If you are on macOS, first try updating to at least 10.13.4.
If you are on a git based installation and git itself runs into problems when trying to download the updates, you should make sure you are on the current version of git for your platform.
A: No, Tautulli can be installed anywhere as long as it has network access to the Plex server whether that be on a local network or even a remote network.
A: Your Plex Server Identifier in the Tautulli settings is mismatched with your Plex server. Please verify your server in the settings and make sure the identifier matches with the one shown by visiting http://SERVER-IP:32400/identity.
A: Clear the media info table cache by going to the following URL, where XX is the ID number for the library.
A: The yellow progress bar is the current stream progress, and the grey bar is the current transcoder progress (not the available buffer on the client device).
A: History is only logged if all those following conditions are satisfied:
After the stream is stopped.
If the total stream duration is longer than the "Ignore interval" you set (Settings > General > Show Advanced).
If "Keep History" for the user is enabled (Users > Edit Mode > Toggle Keep History).
If "Keep History" for the library is enabled (Libraries > Edit Mode > Toggle History).
If you have satisfied all the above requirements, but nothing is still being logged, then the sessions might be stuck inside the database. Go to Settings > General > Show Advanced button at the top > Flush Temporary Sessions > Flush to flush the database, and history logging should be working again.
A: Yes. Tautulli cannot "see" your Plex activity if it isn't running, or retroactively import old history.
A: No, unless you had PlexWatch or Plexivity installed previously and import the database, Tautulli can only start logging history after it is installed.
Although Plex does keep some information in their database, it is nowhere near detailed enough to build the level of history that Tautulli keeps, the above tools keep enough information to build partial records from.
A: "Recently Watched" only shows history that is considered as "watched" (exceed the watched percent that you specify in the settings).
A: Re-Enable "Group Successive Play History" in Settings > General > Show Advanced button.
A: Tautulli can't find your library item YY. You can double check if that item exists by using Tautulli and going to
If the item can't be found then you can flush the temporary sessions database in Settings > General > Show Advanced button at the top > Flush Temporary Sessions > Flush.
A: You can find out which items have not been watched by viewing the Media Info table for the library.
A: You can try fixing your database by following the steps below:
Create a backup of your Tautulli database (tautulli.db) by going to Settings > Import & Backups > Backup Database
Shutdown Tautulli.
Go to the "Execute SQL" tab and run the following SQL:
Go to "File > Write Changes" and "File > Close Database".
Restart Tautulli.
A: There's a websocket bug in the recent PMS versions where streams don't send a "stop" event. Once you restart Tautulli, a stop event is triggered, and the duration is calculated from when the stream started to when Tautulli was restarted.
The only solution at the moment is to manually delete those history entries from the History tab.
A: When you remove something from Plex and then later re-add it, including when you move it between libraries or recreate an entire library it can start showing up multiple times in Tautulli. This is because Tautulli bases it's history recording on the ratingKey provided by Plex, a unique identifier for each item in the library. When you recreate items Plex generates a new ratingKey for the new item... but Tautulli is still referencing the old ratingKey for the history it has recorded!
Okay, so how do I fix it?
This depends on how many items in your history you need to update to their new ratingKey. If you've just moved a single movie, or re-added a TV show then the simplest method is to search Tautulli's history for the old item (either the movie, or an episode from the show). Once you've found the item, open up the /info page for it and hit the Fix Match button. This will bring up a screen allowing you to search your Plex library for where the item is currently. Once you find it's new location and tell Tautulli about it, it will update all history items to the new ratingKey. For TV shows it will update all episodes, so you just need to fix one.
A: This is happening because the lists on the homepage display the Track Artist, but uses the Album Artist for grouping. Plex doesn't provide a linking between track artists and the "real" artist for Tautulli to follow to merge these entries. This means that if you have an artist individually in your library, and they show up in an album of various artists, they will show twice if both are played.
A: If a user is unable to get a direct connection to your Plex server for whatever reason, Plex has a component called "Plex Relay" that will relay their traffic through Plex's servers, allowing them to still connect to your server. Unfortunately since they are not connecting directly, the "address" they are connecting from is the local (127.0.0.1) connection of the Plex Relay service.
A: By default Tautulli filters out playback stop notifications after the watched percentage is exceeded. This is to prevent double notifications (both watched and stopped) when a stream finishes. To disable this filtering, allowing all events to always go through, you need to enable the Notifications & Newsletters -> Show Advanced -> Allow Playback Stop Notifications Exceeding Watched Percent setting.
A: You can control which users/libraries will get logged by going to the Users or Libraries page, going into "Edit mode" and clicking on the "Toggle History" icon beside each user or library you want to enable or disable.
A: The "Live TV" library will only show up the first time you play Live TV in Plex. If you deleted the library, then see the previous answer to add it back.
A: This depends on the client you were using to watch Live TV. Some Plex clients (e.g. Plex Web) will update your Plex Media Server's API when Live TV rolls over into the next show. In this case Tautulli will correctly split the history into separate shows. However, some Plex clients (e.g. Apple TV) do not update your Plex Media Server's API so there is no way for Tautulli to know the show changed. Once this is fixed by Plex, it will automatically work correctly in Tautulli.
A: History logging can be disabled like any other library. Go to the Libraries page, click on the "Edit Mode" button, and click on the "Toggle History" icon for the libraries you wish to disable history logging.
A: No, this is currently not possible. You can only view history for a single episode at a time on the info pages.
A: Click on the graph legends to hide the series from the graphs. The graph series visibility is stored in your browser so this will need to be done for each browser that you use.
A: To be honest: Yes. To be very honest: No. You probably forgot to enable any triggers for your notification agents. If they show with a gray bell in the list then they have no active triggers. Click on the gray bell icon next to the Notification Agent, go to the Triggers tab, and enable any desired triggers for that agent. After you checked at least one trigger and clicked on Save the bell turns satisfying orange-ish.
A: Sometimes the browser cache will cause problems with the test notifications. Do a force refresh on the settings page (CTRL+F5 or OPTION+Reload on Mac/Safari), then try sending a test notification again.
A: You can control which users/libraries will send a notification by setting up a [[custom condition|Custom Notification Conditions]] in your notification agent settings.
A: See previous answer.
A: You probably have "Group notifications for recently added TV Shows or Music" checked in the notification settings. No Season/Episode or Album/Track metadata will be available with this setting enabled.
A: When allowing Tautulli to access your Facebook account, you must select Public or Friends for the app visibility permissions. Selecting Only Me will not work.
A: When Tautulli encounters custom notification text that it fails to parse, it will fall back to the default text so the notification can still be sent out. Generally this is due to using an invalid {parameter} in the text that doesn't exist in Tautulli, or doesn't exist for the specific media item. The error logs will tell you the exact reason your custom text failed to parse, allowing you to correct the mistake.
For example:
A: There are two aspects you might want to change: 1. The PYTHONPATH environment variable
Tautulli will enhance the PYTHONPATH variable with the path of its own bundled libraries, allowing scripts to use any of the bundled libraries without the user needing to have installed them system wide. However, this means that the bundled versions take priority. If you want to disable this feature simply prepend nopythonpath to the script arguments.
The python interpreter used.
Normally scripts ending in .py are executed with python. If you want to change this you can prepend the interpreter in front of the script arguments. Currently allowed overrides: python2, python3, python, pythonw, php, ruby, perl.
Examples:
If you wanted to run a Python 3 script, without the PYTHONPATH changes from Tautulli you would set the arguments to nopythonpath python3 the other arguments.
If you wanted to run a Python 2 script with python2 instead of python and use the bundled libraries from Tautulli, you would set the arguments to python2 the other arguments.
A: When an email message exceeds a certain size in Gmail it is automatically clipped, requiring you to click a "View entire message" link in order to see the full contents. In order to get the Newsletters to render properly in mail clients they have to be rather complex, leading to this check triggering. Unfortunately there is nothing that can be done about this as reducing the complexity leads to issues with mail clients breaking the rendering of the Newsletter. If you have enabled Self Hosted newsletters a link to view the full message is always the first thing in the message and should be visible no matter what.
A: Newsletters follow the date format specified under Settings -> General -> Date Format.
A: The first thing to check is that your image hosting settings are correct. There should be no orange warning text under any of the related settings.
If you have enabled self hosted newsletters, or are using self-hosted images, ensure that your Public Tautulli Domain setting under Web Interface is correct.
If you are using Imgur as your image hosting you will likely run into API limits and some images may be missing. It is recommended to use Cloudinary if you are using an external image hosting service.
A: If you want to change something about how the Newsletters look, such as a custom logo, or changing the text, you need to create a folder containing your templates and point Tautulli at it.
Note: Your folder can be located anywhere Tautulli has access to, but the file must be named recently_added.html.
You can view all the raw JSON data available to be used in the newsletter template by adding &raw=true to the newsletter preview URL. For example:
A: The pyOpenSSL module is not bundled with Python. Run the following in the command line to install it.
If that doesn't work:
Run python -m pip install C:\pyOpenSSL-17.5.0.tar.gz
If you have installed Python into a different directory or saved pyOpenSSL to somewhere else, you have to modify the above command in step 2 accordingly.
A: You most likely forgot the following step when installing Git for Windows. Run the Git installer again, making sure you include the step below.
Run the installer, select all the defaults except for the section called "Adjusting your PATH environment" - here select "Git from the command line and also from 3rd-party software".
A: Delete the update folder inside the Tautulli directory and try updating again.
A: Start Tautulli manually from the command prompt to view the error. Open the Windows command prompt then running the following command. Fill in C:\path\to\tautulli to match the path where Tautulli is installed.
A: If you are seeing this error when trying to start Tautulli the simple fix is to add these lines to your ~/.bash_profile file:
To make this change active you can either restart Terminal, or run the following:
A: Unfortunately, the Python dock icon is required when the menu bar icon is enabled and you are running Tautulli using Python directly. You can either disable the menu bar icon, or reinstall Tautulli using the macOS pkg instead (refer to this [[wiki page|Upgrading to Python 3 (Tautulli v2.5)#windows--macos]] for details). The pkg install will not show any dock icons regardless if the menu bar icon is enabled or disabled.
A: When running a Plex Media Server on a QNAP, Plex writes logs into a non-shared location with the /share/.qpkg path. Tautulli cannot be pointed to this location and you need to create a symbolic link.
SSH into your QNAP device.
Create a directory in a shared folder that will be accessible:
Create symbolic link between unshared log folder and new shared folder:
Your new location is now usable in Settings > Plex Media Server > Show Advanced button > Logs Folder:
If you are running Tautulli as a dedicated user as is recommended in the , it's likely the permissions on files will need to be fixed after running the above commands:
If you instead installed Tautulli by simply downloading the current release archive, the steps are simpler: 1. Download the 2. Shut down Tautulli 3. Extract the current release to the same location where you previously extracted it
The easy and least secure method is to forward an external port (8181) on your router to the internal port used by Tautulli (default is TCP 8181). Visit for instructions for your particular router. You will then be able to access Tautulli via http://EXTERNAL-IP-ADDRESS:8181.
WARNING: If you are re-installing Plex as well please follow . If you are starting from scratch again with Plex, or forgot to do this step, then you MUST run the script from , or your Tautulli database will link to the wrong items!
If you are trying to undelete a user first you will need to find their user_id. You can get this by following the "More XML Shortcuts" instructions for "All Users".
If you are trying to undelete a library you will need to find the section_id. You can get this by following the "More XML Shortcuts" instructions for "All Libraries".
When reporting an issue, please provide a link to this log file by pasting it on , do not upload the file as an attachment.
If you cannot load the Plex Web interface, then you may have a DNS rebinding issue for *.plex.direct addresses. Try changing your system to use a public DNS server, such as or . If you are using a custom DNS server such as on a pfSense firewall, see the "DNS Rebinding" section of this Plex support article on .
If restoring a backup won't work for you, or you want to retain as much history from your current database as possible, then the other alternative is to attempt to repair the database that you currently have. If you are using Windows or Mac OS, then you can try the steps below. Alternatively, you can try using the .
Open your database with .
Go to "Tools > Integrity Check", then click "OK" to run PRAGMA pragma integrity_check; (). If it does not say "ok" then you need to repair your database.
Make sure the box that says "Multiple rows (VALUES) per INSERT statement" is checked ().
Continue running through the steps above. If you run into issues again with the minimal table list it's still possible to recover data, but the process is very involved so we ask that you contact in order to proceed.
A: This is being caused by a combination of several different things. The initial cause is that GitHub has , preventing clients using these standards from accessing their site. This has caused many different aspects of older systems to run into issues when working on updates.
The solution to most of these problems is to simply ensure you are on the latest v3 release of . If that doesn't work for you, the next thing to try is installing the latest version of , instructions for Windows can be found . That should allow Tautulli to talk to GitHub again and check for updates.
If after performing all of the above steps have not solved your issue please join the #support channel of our as there can be many platform specific issues related to this.
A: The recently added section on the homepage is pulled directly from your Plex dashboard. The setting must be enabled for the libraries on your Plex server.
Note: If you are experiencing errors in the log, such as the error, you should fix those first before attempting to flush sessions above.
Open your database with .
A: The bandwidth shown at the bottom of an activity item is Plex's Streaming Brain estimate of required bandwidth to stream the item. This is not necessarily the same as how much bandwidth will actually be used, but instead is the maximum required at the user's chosen bitrate. This can get quite a bit higher than the average bandwidth of the entire item due to the way that video compression works. You can read more detail on the subject and how Plex handles it in the Bitrates and How They Matter section of .
If you instead recreated an entire library, you might find it easier to setup and use the script, which will automate the above task for everything in your library. Note that you will likely need to manually fix some items using the above method after running this, it will print warnings about the items it was unable to match automatically.
For more information on this, and several potential solutions to fixing the connection issues and enabling direct access to your server, please refer to the support article from Plex.
A: This "fake" library is used to collect all the Live TV history together. If you don't want to see this then you can go to the Libraries page, click on the "Edit Mode" button, delete the library, and it will not reappear again. If in the future you want to re-enable the library, then you will need to the library (section_id=999999). Note that, just like any other library, deleting the Live TV library will prevent history from being recorded while it is deleted.
A: Posters are only available for notification agents which have the "" or "" options in the settings, with the exception of Email. If you are using any of those agents, make sure you have Imgur upload setup (see the next question), and the poster will automatically be included with notification. For Email, make sure you have "" checked in the Email settings, then you may use an HTML image tag to add the poster to body of your notification, for example: <img src="{poster_url}" height="225" width="150">
A: First you must create an , then register a new application . Enter an Application Name, Email, and Description, and select the option "OAuth 2 authorization without a callback URL". You will receive a new client_id for your application. Enter this value for the "Imgur Client ID" in the Tautulli settings.
A: Your Facebook Group ID is incorrect. If your group has a named URL, you'll need to find the ID number using a tool like . Your group will need to be open in order for that tool to work. You can change the group back to closed/secret once you have the group ID number.
A: The PyCryptodome library is required to encrypt notifications sent to your Remote Android App. Installation instructions can be found in .
A: Same as the FAQ answer .
A: Newsletters use Plex's Recently Added list in order to generate the content for the Newsletter, as such if you have unchecked in the libraries Advanced settings in Plex, then it won't show in the Newsletter.
If you have checked the above and images in the newsletter are working for some users but not others, we have found that some email clients are buggy and do not display the images in the newsletter. Tautulli doesn't support clients that exhibit these issues, if you are interested in supporting these clients please use the functionality. Known problematic clients are the default Mail.app on iOS and some Microsoft Outlook versions.
It's recommended to copy the current template to start off with. Download to a folder of your choice. You can then edit the recently_added.html file to match what you would like the newsletters to look like. The templating language in use here is .
After you have that set up, you need to tell Tautulli to use the new template. Do this by filling in the full path to the folder you created above in the Settings > Notifications & Newsletters > Show Advanced button > option.
Download the latest version of pyOpenSSL (the source .tar.gz file) and save it to C:\.
Note: If you are seeing this and aren't running Windows, it's likely you are hitting the FAQ entry!
A: This seems to be a version mismatch with the packaged Python sqlite3 libraries. Download the latest "Precompiled Binaries for Windows" from and place the extracted sqlite3.dlls file in C:\Python27\DLLs.
A: Please refer to the instructions under the wiki.
Then refer to above.
A: Run the following command in the terminal (according to this ):
