Skip to content
tau.how

Service Management

Starting tau is a straightforward process, but it’s often more useful to have it managed by a system manager like systemd, which can handle starting, stopping, and restarting the service as needed. Here, we’ll cover a simple systemd service configuration for tau.

You can start tau manually by using the following command:

tau start -s <shape> -c <config-file>

Where <shape> is the name of your desired shape, and <config-file> is the path to the configuration file for that shape.

For systemd management, you can use the following configuration (e.g., in a file named /etc/systemd/system/tau@.service):

[Unit]
Description=Taubyte tau Service Running %i

[Service]
Type=simple
ExecStart=/tb/bin/tau start -s %i -c /tb/config/%i.yaml
StandardOutput=journal

Restart=always
RestartSec=1

[Install]
WantedBy=multi-user.target

In this configuration file:

  • %i represents the shape name, which will be replaced with the actual shape name when the service is started.
  • The ExecStart line specifies the command to start the tau instance for a specific shape.
  • The Restart=always line ensures that the service will always be restarted if it stops for any reason.
  • The RestartSec=1 line specifies a one-second delay before the service is restarted.

With this systemd configuration in place, you can manage tau instances for different shapes easily. For example, to start an tau instance for a shape named shapeA, you would use the following command:

systemctl start tau@shapeA

This command will start an tau instance running the shapeA configuration. You can use similar commands to stop or restart the service. The @ symbol in the service name allows you to specify the shape name when controlling the service.