mirror of
https://github.com/Tautulli/Tautulli.git
synced 2025-03-12 04:35:40 -07:00
51d1dccb42
systemd units allow to run processes in foreground while daemonization is done on systemd service level when using Type=simple (default). This allows systemd to reliably track the service state, signals and could catch outputs, i.e. it is possible to remove "--quiet" to have Tautulli logging to systemd journal (journalctl) additionally or alternatively to log files. In case of Type=forking, a PID file is required to allow system reliably determine the service state, which would be an alternative, but has no real advantage. The solution with "GuessMainPID=no" allows systemd to correctly determine the service active state, but e.g. when it is killed, it is seen as "Succeeded." since systemd cannot track the exit code or signal.
65 lines
2.5 KiB
Plaintext
65 lines
2.5 KiB
Plaintext
# Tautulli - Stats for Plex Media Server usage
|
|
#
|
|
# Service Unit file for systemd system manager
|
|
#
|
|
# INSTALLATION NOTES
|
|
#
|
|
# 1. Copy this file into your systemd service unit directory (often '/lib/systemd/system')
|
|
# and name it 'tautulli.service' with the following command:
|
|
# cp /opt/Tautulli/init-scripts/init.systemd /lib/systemd/system/tautulli.service
|
|
#
|
|
# 2. Edit the new tautulli.service file with configuration settings as required.
|
|
# More details in the "CONFIGURATION NOTES" section shown below.
|
|
#
|
|
# 3. Enable boot-time autostart with the following commands:
|
|
# systemctl daemon-reload
|
|
# systemctl enable tautulli.service
|
|
#
|
|
# 4. Start now with the following command:
|
|
# systemctl start tautulli.service
|
|
#
|
|
# CONFIGURATION NOTES
|
|
#
|
|
# - The example settings in this file assume that you will run Tautulli as user: tautulli
|
|
# - The example settings in this file assume that Tautulli is installed to: /opt/Tautulli
|
|
#
|
|
# - To create this user and give it ownership of the Tautulli directory:
|
|
# 1. Create the user:
|
|
# Ubuntu/Debian: sudo addgroup tautulli && sudo adduser --system --no-create-home tautulli --ingroup tautulli
|
|
# CentOS/Fedora: sudo adduser --system --no-create-home tautulli
|
|
# 2. Give the user ownership of the Tautulli directory:
|
|
# sudo chown -R tautulli:tautulli /opt/Tautulli
|
|
#
|
|
# - Adjust ExecStart= to point to:
|
|
# 1. Your Python interpreter (get the path with "command -v python3")
|
|
# - Default: /usr/bin/python3
|
|
# 2. Your Tautulli executable
|
|
# - Default: /opt/Tautulli/Tautulli.py
|
|
# 3. Your config file (recommended is to put it somewhere in /etc)
|
|
# - Default: --config /opt/Tautulli/config.ini
|
|
# 4. Your datadir (recommended is to NOT put it in your Tautulli exec dir)
|
|
# - Default: --datadir /opt/Tautulli
|
|
#
|
|
# - Adjust User= and Group= to the user/group you want Tautulli to run as.
|
|
#
|
|
# - WantedBy= specifies which target (i.e. runlevel) to start Tautulli for.
|
|
# multi-user.target equates to runlevel 3 (multi-user text mode)
|
|
# graphical.target equates to runlevel 5 (multi-user X11 graphical mode)
|
|
|
|
[Unit]
|
|
Description=Tautulli - Stats for Plex Media Server usage
|
|
Wants=network-online.target
|
|
After=network-online.target
|
|
|
|
[Service]
|
|
ExecStart=/usr/bin/python3 /opt/Tautulli/Tautulli.py --config /opt/Tautulli/config.ini --datadir /opt/Tautulli --quiet --nolaunch
|
|
User=tautulli
|
|
Group=tautulli
|
|
Restart=on-abnormal
|
|
RestartSec=5
|
|
StartLimitInterval=90
|
|
StartLimitBurst=3
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|