Skip to content

Install on Linux

The Linux source node runs as a systemd service and starts automatically on boot. It uses a single pre-built binary — no Python runtime or virtual environment needed. It supports self-updating: new versions (engine packs) are applied automatically when signalled by the Hub.


Prefer containers? The source node also ships as a container image with a Helm chart — same engines, same credentials.

  • Linux with systemd (Ubuntu/Debian)
  • curl installed — the installer auto-installs it on Debian/Ubuntu
  • Network connectivity to the Hub host and port (outbound TCP — no inbound rules needed)
  • Network connectivity to the controller URL (for downloading the binary and updates)
  • sudo privileges
  • Your node’s Client ID and Client Secret — shown once when you create the node (or regenerate its secret) on the Nodes screen (see the Nodes reference)

The installer script handles everything: creating the service user, downloading the binary, writing the systemd unit, and enabling the service.

Terminal window
sudo ./install.sh --client-secret <your-client-secret>

Run this from the folder containing the installer package (the zip with install.sh and the binary), or download the binary from your controller:

Terminal window
sudo ./install.sh --controller-url https://<controller-url> --client-secret <your-client-secret>

Get the installer package from your platform administrator. It contains install.sh, uninstall.sh, and the nexomatic-source-node binary (the binary is also fetchable from the controller’s downloads API when you pass --controller-url).

Terminal window
chmod +x install.sh
sudo ./install.sh --controller-url https://<controller-url> --client-secret <your-client-secret>

The installer:

  1. Installs curl if missing
  2. Creates the nexomatic service user
  3. Installs the binary to /opt/nexomatic-source-node/
  4. Writes the nexomatic-source-node.service systemd unit with your configuration
  5. Enables the service and offers to start it

Useful installer options:

OptionMeaning
--hub-host / --hub-port / --no-hub-tlsHub endpoint (defaults to the platform’s public hub with TLS)
--client-id / --client-secretNode credentials from the Nodes screen (create a source node there first)
--node-versionVersion string written to the install’s VERSION file
--update-base-urlBase URL for self-update packages
Terminal window
sudo systemctl status nexomatic-source-node
sudo journalctl -u nexomatic-source-node -f

A healthy start logs Registered node … followed by heartbeats. Once connected, your self-hosted sources appear on the Sources screen and the node’s workers show up in the journal as Spawned worker (type=…) lines.


Terminal window
sudo /opt/nexomatic-source-node/uninstall.sh

Pass --keep-data to preserve the node’s data directory (assignments, cursors, node identity).