Skip to Content
Runner installationLinux

Install the Runner on Linux

Requirements

  • x86-64 or ARM64 Linux
  • systemd
  • curl
  • sha256sum
  • Root access through sudo

Install

Open Settings → Integrations, select Add runner, enter a name and site, then choose Linux. Generate the command and run that exact command on the server.

The command looks like this:

curl -fsSL 'https://get.musterly.io/runner' | sudo env PAIRING_CODE='XXXXXX' bash

The installer downloads the correct build for the machine, creates the musterly-runner systemd service and starts it.

Verify

systemctl status musterly-runner
journalctl -u musterly-runner -f

A healthy service connects, fetches its assigned connector and starts syncing. Musterly should show the Runner as Online within a few moments.

Updates

The Runner checks for updates. When an update is installed, systemd restarts it.

Useful service commands

sudo systemctl restart musterly-runner
sudo systemctl stop musterly-runner
sudo journalctl -u musterly-runner --since "30 minutes ago"

If the download fails

The installer downloads release information and the Runner from GitHub. Test the same route as root:

sudo curl -4 -v --connect-timeout 10 --max-time 30 \
  https://api.github.com/repos/Musterly/musterly-runner-dist/releases/latest

See Troubleshooting for DNS, proxy, certificate and firewall checks.

Last updated on
Runner overviewWindows