Skip to main content
Version: Developer

Using systemd for Kasm Service Management

Kasm Workspaces provides systemd service integration, allowing admins to manage Kasm services using standard systemd commands ensuring proper initialization order of all plugins and components.

Service Names

Kasm automatically installs the following systemd services:

Service NameDescription
kasm.serviceMain Kasm service that controls all components
kasm-network-plugin.serviceKasm Network Plugin service that manages the docker network plugin providing egress capabilities

Service Management

To list all installed Kasm related services:

sudo systemctl list-unit-files | grep kasm

To check the status of Kasm services:

sudo systemctl status kasm
sudo systemctl status kasm-network-plugin

To start/stop/restart all Kasm services:

# start
sudo systemctl start kasm

# stop
sudo systemctl stop kasm

# restart
sudo systemctl restart kasm

Enable/Disable Automatic Startup

Kasm services are enabled by default during installation to automatically start at system boot.

To manage automatic startup of all Kasm services at boot:

# enable
sudo systemctl enable kasm

# disable
sudo systemctl disable kasm

Troubleshooting Startup Issues

If you encounter issues with Kasm services starting up, check the following:

  1. Verify the service status:

    sudo systemctl status kasm
  2. Check for error messages in the startup logs:

    sudo journalctl -u kasm -n 100
  3. Ensure Docker is running, as Kasm requires it to start properly:

    sudo systemctl status docker
  4. Check if all required services are enabled for automatic startup:

    sudo systemctl list-unit-files | grep kasm