Documentation
Guides
Start on system boot

Start on system boot

In this section, we'll cover how to configure Tipi to start on system boot. These steps assume a systemd distro (the majority of common Linux distributions use systemd as the init manager). To determine whether your system uses systemd, run the command sudo systemctl status - if it displays a tree of daemons, you have systemd.

Add Tipi to systemd

Create a service configuration file

Create the file in /etc/systemd/system:

sudo touch /etc/systemd/system/tipi.service
💡

This path may vary according to your distribution.

Edit the file

sudo nano /etc/systemd/system/tipi.service, and paste in this config:

[Unit]
Description=Runtipi service
Requires=docker.service multi-user.target
After=docker.service network-online.target

[Service]
Restart=always
RemainAfterExit=yes
WorkingDirectory=/path/to/runtipi
ExecStart=/path/to/runtipi/runtipi-cli start
ExecStop=/path/to/runtipi/runtipi-cli stop

[Install]
WantedBy=multi-user.target
💡

Replace /path/to/runtipi with the full path to wherever you installed Tipi.

Update the systemd configuration:

sudo systemctl daemon-reload

Enable the service:

sudo systemctl enable tipi

Test the service configuration:

sudo systemctl status tipi
● tipi.service - tipi
     Loaded: loaded (/etc/systemd/system/tipi.service; disabled; vendor preset: enabled)
     Active: inactive (dead)

Reboot your system

Test that Tipi starts up. If this all worked, you should now be able to manage tipi with systemctl:

sudo systemctl status tipi
● tipi.service - tipi
     Loaded: loaded (/etc/systemd/system/tipi.service; enabled; vendor preset: enabled)
     Active: active (exited) since Wed 2023-02-22 00:43:34 GMT; 4 days ago
   Main PID: 11537 (code=exited, status=0/SUCCESS)
      Tasks: 1 (limit: 4915)
        CPU: 4d 11h 24min 33.300s
     CGroup: /system.slice/tipi.service
             └─11647 fswatch -0 /usr/bin/runtipi/state/events