# How To Install Teamscale as a Linux Service
You might want to install Teamscale as a Linux service to allow for more consistent management with other services on the same machine and to ensure that Teamscale is automatically started after a reboot. Additionally, this allows Teamscale to automatically restart in case of a crash.
Before installing Teamscale as a service, ensure that the basic configuration was completed and that Teamscale can be started manually.
The required files are located in the folder
linux in the Teamscale installation directory.
You can choose between a
systemd-based installation or an
Most modern Linux distributions support systemd (opens new window).
To see if your system supports, check for the existence of the directory
/lib/systemd or the command
(This procedure was tested on Ubuntu 20.04.)
# Installing Teamscale as a systemd Service
Modify the file
linux/systemd/teamscale.serviceaccording to the TODO comments inside.
Copy the file to
Reload the systemd daemon to register the new service by running:
sudo systemctl daemon-reload
Enable the service to start at boot time by running the following command:
sudo systemctl enable teamscale.service
To start the service manually use the following command:
sudo systemctl start teamscale.service
# Uninstalling the Teamscale systemd Service
To uninstall the systemd service, run the following commands:
sudo systemctl stop teamscale.service sudo systemctl disable teamscale.service
remove the file you copied to
The following guide for
init.d is deprecated (this procedure was tested with Ubuntu 12.04).
If possible use
# Installing Teamscale as a init.d Service
Edit the file
Enter or edit the correct path to the Teamscale root directory. For example:
Enter or edit the correct path to the Java installation directory. For example:
Optionally uncomment and fill the
EXTRA_START_ARGSline to run the services as a different user.
Install the service by running from the command line:
sudo ./install-service.sh teamscale
Start the service by running the following command:
sudo service teamscale start
# Uninstalling the Teamscale init.d Service
If you later have to uninstall the
init.d service run the following command:
sudo ./uninstall-service.sh teamscale