WindowsLinux

Where Does Tautulli Store History and Config?

Tautulli keeps watch history and settings in tautulli.db and config.ini inside its data folder. Locations and migration rules.

Last updated

Tautulli keeps its state in two files inside its data folder: tautulli.db with all watch history and statistics, and config.ini with server settings. Where that folder lives depends on install type: beside the program for classic installs, behind /config for Docker, wherever the service file says otherwise.

The supported migration path runs through the web UI, not the filesystem: download both files from Help & Info, import them on the new install. That route works across operating systems where raw copies break. Scheduled backups accumulate in the backups subfolder, and the official restore is renaming the newest one over the live database while stopped.

Where Tautulli stores this, by platform

Windows
C:\Tautulli

tautulli.db holds history and stats; config.ini holds server settings; backups accumulate in backups. Find exact paths on Settings, Help & Info. Migrate via download and reimport, which works cross-OS. Stop before any filesystem copy so SQLite is consistent.

Linux
/opt/Tautulli

Classic installs use /opt/Tautulli with --config and --datadir flags; service files relocate both. Docker hides everything behind the /config mount. Find exact paths on Settings, Help & Info. Same UI import path covers cross-OS moves; raw copies only within the same OS.

Frequently asked questions

how do i move tautulli to a new server

Download both files from Settings, Help & Info, then import them on the new install via Settings, Import & Backup. History and settings transfer between any OS this way, which beats copying folders across platforms. Reinstall Plex-side tokens afterward if the server moved too.

how do i restore a corrupt tautulli database

Stop Tautulli, rename the current tautulli.db aside, and copy the newest backups/tautulli.backup file over it as tautulli.db. Restart and confirm history returns. The wiki documents this exact sequence; the scheduled backups folder exists precisely for this moment.

can i migrate tautulli across operating systems

Yes, through Settings, Import & Backup, which accepts the pair from any OS. Raw folder copies across platforms break on path differences, but the import path normalizes them. Same-OS moves can copy the whole data folder while stopped.

Notice an outdated path? Let us know.