mirror of
https://github.com/Tautulli/Tautulli.git
synced 2025-07-08 06:00:51 -07:00
114 lines
No EOL
5.4 KiB
Markdown
114 lines
No EOL
5.4 KiB
Markdown
### Operating Systems:
|
|
|
|
* [Windows / macOS](#windows--macos)
|
|
* [Linux](#linux)
|
|
* [FreeBSD / FreeNAS](#freebsd--freenas)
|
|
|
|
----
|
|
|
|
## Windows / macOS
|
|
|
|
### Important changes
|
|
|
|
Running Tautulli in the background on startup can be enabled by checking Tautulli Settings > Web Interface > Launch at System Startup.
|
|
* **Warning**: Make sure to remove any previous Tautulli shortcut from your startup folder or task in Windows Task Scheduler on Windows, or `.plist` files in your `LaunchAgents` folder on macOS, to prevent conflicts with the Tautulli setting! Refer to the deprecated instructions in the [[Install as a Daemon]] page.
|
|
|
|
### Reinstalling Tautulli using the app installer (recommended)
|
|
|
|
* Tautulli v2.5 and above can be installed on Windows or macOS (10.14 or newer) _without_ needing to install Python. You can download the new Windows `.exe` or macOS `.pkg` installer from the [GitHub Releases page](https://github.com/Tautulli/Tautulli/releases/latest).
|
|
|
|
#### Instructions:
|
|
|
|
1. Go to the Tautulli Settings > Help & Info page.
|
|
1. Click on the "Database File" link to download a copy of your Tautulli database.
|
|
1. Click on the "Configuration File" link to download a copy of your Tautulli configuration.
|
|
1. Shutdown Tautulli.
|
|
1. Install Tautulli using the Windows `.exe` or macOS `.pkg` installer.
|
|
1. Start Tautulli and complete the setup wizard.
|
|
1. Go to the Tautulli Settings > Import & Backup page and re-import the database file (using the "Overwrite" method) and configuration file that you saved in the steps above.
|
|
1. Once you have the database imported and Tautulli successfully configured, you may uninstall the previous version of Tautulli by deleting the old folder (Windows: `C:\Tautulli` or macOS: `/Applications/Tautulli`).
|
|
|
|
#### Notes:
|
|
|
|
* Python still needs to be installed if you are running Python script notifications.
|
|
* To update Tautulli using the app installer, just download and run the new installer when a new update is available.
|
|
|
|
|
|
## Linux
|
|
|
|
### Reinstalling Tautulli using the Snap package (recommended)
|
|
|
|
* Tautulli v2.6.3 and above can be installed on most Linux distributions using the Snap package _without_ needing to install Python.
|
|
|
|
#### Instructions:
|
|
|
|
1. Go to the Tautulli Settings > Help & Info page.
|
|
1. Click on the "Database File" link to download a copy of your Tautulli database.
|
|
1. Click on the "Configuration File" link to download a copy of your Tautulli configuration.
|
|
1. Shutdown Tautulli.
|
|
1. Install Tautulli using `snap` by following the [[Installation | Installation#linux]] instructions.
|
|
1. Start Tautulli and complete the setup wizard.
|
|
1. Go to the Tautulli Settings > Import & Backup page and re-import the database file (using the "Overwrite" method) and configuration file that you saved in the steps above.
|
|
1. Once you have the database imported and Tautulli successfully configured, you may uninstall the previous version of Tautulli by deleting the old folder (`/opt/Tautulli`) and the old service file (`/lib/systemd/system/tautulli.service`).
|
|
|
|
#### Notes:
|
|
|
|
* Python still needs to be installed if you are running Python script notifications.
|
|
* Snap packages update automatically outside of Tautulli.
|
|
|
|
### Modifying an existing Tautulli install (alternative)
|
|
|
|
* This will update an existing Tautulli systemd service script that is using Python 2 to Python 3.
|
|
|
|
#### Instructions:
|
|
|
|
1. Make sure Tautulli is shutdown or run `sudo systemctl stop tautulli.service`.
|
|
1. Get the path to your `python3` interpreter using `command -v python3`.
|
|
* Note: You may need to replace `python3` with the correct value for your system (e.g. `python3.7`).
|
|
1. Edit `/lib/systemd/system/tautulli.service`.
|
|
1. Add the path to your `python3` interpreter from step 1 to the start of the `ExecStart=` command (e.g. `/usr/bin/python3`).
|
|
* Example:
|
|
```
|
|
ExecStart=/usr/bin/python3 /opt/Tautulli/Tautulli.py --config /opt/Tautulli/config.ini --datadir /opt/Tautulli --quiet --daemon --nolaunch
|
|
```
|
|
1. Start Tautulli with `sudo systemctl daemon-reload && sudo systemctl start tautulli.service`.
|
|
|
|
#### Notes:
|
|
|
|
* If Tautulli will not start with the error `ImportError: bad magic number in 'pkg_resources'`, run the `clean_pyc.sh` file inside the Tautulli `contrib` folder.
|
|
```
|
|
cd /opt/Tautulli/contrib
|
|
./clean_pyc.sh
|
|
```
|
|
|
|
|
|
## FreeBSD / FreeNAS
|
|
|
|
### Modifying an existing Tautulli install
|
|
|
|
* This will update an existing Tautulli service script that is using Python 2 to Python 3.
|
|
|
|
#### Instructions:
|
|
|
|
1. Make sure Tautulli is shutdown or run `service tautulli stop`.
|
|
1. Install all the prerequisites from the [[Installation | Installation#freebsd--freenas]] instructions.
|
|
1. Remove the old symbolic link to Python 2 with `rm /usr/local/bin/python`.
|
|
1. Create a new symbolic link to Python 3 with `ln -s /usr/local/bin/python3 /usr/local/bin/python`.
|
|
1. Check the python version with `python -V` and it should say Python 3.7.x.
|
|
1. Edit `/usr/local/etc/rc.d/tautulli`.
|
|
1. Add `command_interpreter="python"` above the `command` line (line 41).
|
|
* Example:
|
|
```
|
|
command_interpreter="python"
|
|
command="${tautulli_dir}/Tautulli.py"
|
|
command_args="--daemon --pidfile ${tautulli_pid} --quiet --nolaunch ${tautulli_flags}"
|
|
```
|
|
1. Start Tautulli with `service tautulli start`.
|
|
|
|
#### Notes:
|
|
|
|
* If Tautulli will not start with the error `ImportError: bad magic number in 'pkg_resources'`, run the `clean_pyc.sh` file inside the Tautulli `contrib` folder.
|
|
```
|
|
cd /usr/local/share/Tautulli/contrib
|
|
./clean_pyc.sh
|
|
``` |