Standalone Driver
Deploy the standalone driver on a separate machine from the cluster.
The standalone driver makes it possible to integrate data acquisition hardware from multiple host machines into a single Synnax deployment.
Step 1 Installation
To get started, you’ll need to install the Synnax standalone driver. Choose your operating system below to see the installation instructions:
Install and Run the Driver
The Synnax standalone driver is not yet supported on Windows.
Install and Run the Driver
The Synnax standalone driver is not yet supported on macOS.
Prerequisites
Supported Hardware & Software
The Synnax standalone driver supports the cRIO-904x and cRIO-905x families of controllers running NI Linux Real-Time 2024 Q1 and later.
NI-DAQmx Programming Mode
Data acquisition hardware connected to the cRIO must be configured to use the NI-DAQmx real-time programming mode.
To change the programming mode, use NI Measurement & Automation Explorer (MAX). For detailed instructions, see the NI CompactRIO User Manual and the NI-DAQmx on CompactRIO guide.
SSH Access
The easiest way to install the Synnax standalone driver is to use an SSH connection to the cRIO. Once the driver is installed, SSH can be disabled, although we recommend keeping it enabled to install updates and manage the driver.
Network Available Cluster
In order to function properly, the standalone driver must be able to connect to a Synnax cluster running on the same local network. Make sure you have a cluster running and have the connection parameters on hand.
Install and Run the Driver
Installing the Synnax standalone driver is as simple as opening an SSH connection to the cRIO and running the following command:
curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.41.1/install-driver-nilinuxrt.sh && chmod +x install-driver-nilinuxrt.sh && ./install-driver-nilinuxrt.shThis will download, install, and start the Synnax standalone driver. Once the driver is installed, we’ll need to configure it to connect to your cluster.
Install and Run the Driver
To install and start the driver on Linux, run the following command:
curl -LO github.com/synnaxlabs/synnax/releases/download/synnax-v0.41.1/synnax-driver-v0.41.1-linuxThis will download, install, and start the Synnax standalone driver. Once the driver is installed, we’ll need to configure it to connect to your cluster.
Step 2 Connect to a Cluster
To connect to a cluster, you’ll need to know the cluster’s IP address, port, username,
and password. Then run the synnax-driver login command:
synnax-driver loginThis will prompt you to enter the cluster’s connection parameters. Once you’ve entered the parameters, the driver will automatically connect to the cluster. Here’s an example of the output:
synnax-driver login
host (default: localhost): 10.0.0.45
port (default: 9090): 9090
username: synnax
password:
I20250318 04:57:06.681439 25261 login.cpp:47] connecting to Synnax at 10.0.0.45:9090
I20250318 04:57:06.792840 25261 login.cpp:53] successfully logged in!
I20250318 04:57:06.793918 25261 login.cpp:59] credentials saved successfully Step 3 Check the Driver Status
As a final step, you can check the driver’s status by running the synnax-driver status
command:
synnax-driver statusThis will print the driver’s status to the console. Here’s an example of the output:
I20250318 05:07:04.312907 5935 daemon_nilinuxrt.cpp:490] Checking service status
I20250318 05:07:04.346398 5937 version.cpp:21] Synnax Driver v0.39.0 (2025-03-16 00:08:18)
Synnax Driver is running (PID: 28191)CLI Reference
Start
The start command starts the driver as a background process on the host machine.
Example Usage
synnax-driver startTo start the driver as a foreground process, use the --standalone flag:
synnax-driver start --standaloneFlags
| Flag | Default | Description |
|---|---|---|
--standalone/-s | false | Run the driver directly within the terminal process. |
Stop
The stop command stops the driver.
Example Usage
synnax-driver stopRestart
The restart command restarts the driver. This is equivalent to stopping and then
starting the driver.
Example Usage
synnax-driver restartLogin
The login command logs in to a Synnax cluster.
Example Usage
synnax-driver loginThis will prompt you to enter the cluster’s connection parameters. Once you’ve entered the parameters, the driver will automatically connect to the cluster. Here’s an example of the output:
synnax-driver login
host (default: localhost): 10.0.0.45
port (default: 9090): 9090
username: synnax
password:Status
The status command prints the driver’s status to the console.
Example Usage
synnax-driver statusUninstall
The uninstall command uninstalls the driver.
Example Usage
synnax-driver uninstallLogs
The logs command prints the driver’s logs to the console.
Example Usage
synnax-driver logsVersion
The version command prints the driver’s version to the console.
Example Usage
synnax-driver version