Update, restart or uninstall the Runner

Restarting or updating the Runner does not remove the UniFi Access connection from Musterly. Uninstalling stops future syncs but does not automatically delete data already held in the workspace.

Before maintenance

Open Settings → Runners and note the Runner name, assigned connection and latest successful sync. If you are replacing the host, disconnect or revoke the old Runner after the replacement is online.

Windows

Restart

Restart the Musterly Runner from the Windows service or application controls available on the host. Confirm that its status returns to Online in Musterly.

Update

The Windows Runner checks for updates when it starts and every four hours. It downloads and installs an available update silently, then relaunches automatically. If your organisation manages application deployment centrally, install the current Musterly Runner package over the existing installation.

Uninstall

1. Open Installed apps in Windows.
2. Find Musterly Runner and choose Uninstall.
3. In Musterly, open Settings → Runners and revoke or remove the old Runner record when it will no longer be used.

Local Runner state is retained by the Windows uninstaller so an accidental uninstall does not silently discard pairing information. Remove retained application data only when your organisation intends to decommission the host fully.

Linux

Restart

sudo systemctl restart musterly-runner
sudo systemctl status musterly-runner

Update

Use the current install command from Settings → Runners. The installer replaces the Runner binary while preserving the service configuration. Confirm the reported version and latest heartbeat afterwards.

Uninstall

sudo systemctl disable --now musterly-runner
sudo rm /etc/systemd/system/musterly-runner.service
sudo systemctl daemon-reload

Then remove the installed Runner binary and /etc/musterly-runner/env using your organisation’s approved administration process. The environment file can contain a pairing value and should be handled as sensitive configuration. Remove /var/lib/musterly-runner only when you deliberately want to erase the local Runner profile.

Finally, revoke or remove the old Runner in Musterly.

Verify the result

After a restart or update, the Runner should report Online, then record a successful sync. After a permanent uninstall, Musterly should show the Runner as offline until its record is revoked or removed. Existing workspace history remains governed by Musterly’s retention settings.