Manage Kasm Workspaces services with systemd
Kasm Workspaces integrates with systemd so administrators operate the platform through standard service commands. The integration enforces the correct initialization order across all plugins and components, which keeps reboots and maintenance predictable. This page documents the installed services and the systemctl commands that control them.
Service names
Kasm Workspaces installs the following systemd services automatically during installation.
| Service name | Description |
|---|---|
kasm.service | Main Kasm Workspaces service that controls all components. |
kasm-network-plugin.service | Service that manages the Docker network plugin providing egress capabilities. |
List installed services
To list every installed Kasm Workspaces service, run the following command.
sudo systemctl list-unit-files | grep kasm
Check service status
To check the status of the Kasm Workspaces services, run the following commands.
sudo systemctl status kasm
sudo systemctl status kasm-network-plugin
Start, stop, and restart services
The kasm service controls all components, so these commands manage the full platform.
# start
sudo systemctl start kasm
# stop
sudo systemctl stop kasm
# restart
sudo systemctl restart kasm
Enable or disable automatic startup
Kasm Workspaces services are enabled by default during installation, so they start automatically at system boot. To change this behavior, use the following commands.
# enable
sudo systemctl enable kasm
# disable
sudo systemctl disable kasm
Troubleshoot startup issues
If the Kasm Workspaces services fail to start, work through the following checks.
-
Verify the service status.
sudo systemctl status kasm -
Check the startup logs for error messages.
sudo journalctl -u kasm -n 100 -
Confirm that Docker is running, because Kasm Workspaces requires it to start.
sudo systemctl status docker -
Confirm that the required services are enabled for automatic startup.
sudo systemctl list-unit-files | grep kasm