Skip to main content
Capsule runs as a systemd service so it can execute scheduled backups automatically and restart after a server reboot.

​
Subcommands

CommandDescription
sudo capsule install-serviceInstall and enable the systemd service
sudo capsule uninstall-serviceRemove the systemd service
Check status and control the service directly with systemctl: 
# Check if the service is running
systemctl status capsule

# Start / stop / restart
sudo systemctl start capsule
sudo systemctl stop capsule
sudo systemctl restart capsule

# View live logs
journalctl -u capsule -f

​
Install the service

sudo capsule install-service
This creates /etc/systemd/system/capsule.service, enables it, and starts it immediately. The service:
  • Runs as the current user
  • Starts automatically on boot
  • Restarts on failure (5-second delay)

​
Uninstall the service

sudo capsule uninstall-service
Stops and removes the systemd unit. Your connections, schedules, and config are not affected.

​
Restrict network access (optional)

For tighter security, you can lock the service to only communicate with Capsule’s API by adding network restrictions to the service file: 
# /etc/systemd/system/capsule.service
[Service]
IPAddressAllow=api.trycapsule.xyz
IPAddressDeny=any
After editing, reload and restart: 
sudo systemctl daemon-reload && sudo systemctl restart capsule

​
Troubleshooting

Service won’t start Check the logs: 
journalctl -u capsule -n 50 --no-pager
Scheduled backups not running Confirm the service is active: 
systemctl is-active capsule
If it’s inactive, start it: 
sudo systemctl start capsule