Skip to content
Sistemo
GitHub Docs Install

Systemd Service

Install sistemo as a systemd service so the daemon starts automatically on boot.

Install

sudo sistemo service install

This writes a unit file to /etc/systemd/system/sistemo.service, enables it, and starts the daemon.

Manage

# Check status
systemctl status sistemo

# Follow logs
journalctl -u sistemo -f

# Stop
sudo systemctl stop sistemo

# Restart
sudo systemctl restart sistemo

Uninstall

sudo sistemo service uninstall

This stops the service, disables it, removes the unit file, and reloads systemd.

What the unit file looks like

[Unit]
Description=Sistemo Machine Manager
After=network.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/path/to/sistemo up --data-dir=/home/you/.sistemo
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

The binary path and data directory are detected automatically from the running binary.

What survives a reboot

  • The sistemo0 bridge is recreated on daemon startup
  • Running machines are rehydrated from disk (PID files checked)
  • Port expose rules are restored from SQLite
  • IP allocations are preserved in the database

Warning

Machine processes themselves do not survive a reboot (Firecracker is not checkpointed). Machines that were running before the reboot will need to be started again with sistemo machine start <name>.