Launching on boot

You will probably want to launch sauna as a service as opposed as attached to a shell. This page presents a few possibilities for doing that.


If you installed sauna via the Debian package, everything is already taken care of and you can skip this part.

Creating a user

Sauna does not need to run as root, following the principle of least privilege, you should create a user dedicated to sauna:

adduser --system --quiet --group --no-create-home sauna


If your distribution comes with the systemd init system, launching sauna on boot is simple. Create a systemd unit file at /etc/systemd/system/sauna.service:

Description=Sauna health check daemon

ExecStart=/opt/sauna/bin/sauna --config /etc/sauna.yml


Indicate in ExecStart the location where you installed sauna and in User which user will run sauna.

Enable the unit, as root:

# systemctl daemon-reload
# systemctl enable sauna.service
Created symlink to /etc/systemd/system/sauna.service.
# systemctl start sauna.service
# systemctl status sauna.service
● sauna.service - Sauna health check daemon
   Loaded: loaded (/etc/systemd/system/sauna.service; enabled)
   Active: active (running) since Sat 2016-05-14 13:13:16 CEST; 1min 17s ago
 Main PID: 30613 (sauna)
   CGroup: /system.slice/sauna.service
           └─30613 /opt/sauna/bin/python3.4 /opt/sauna/bin/sauna --config /etc/sauna.yml


Supervisor is a lightweight process control system used in addition of init systems like systemd or SysVinit.

Create a supervisor definition for sauna:

command=/opt/sauna/bin/sauna --config /etc/sauna.yml

Load the new configuration:

$ supervisorctl reread
$ supervisorctl update