Skip to main content
Before deploying config instances, we must first install the Miru Agent on the target machine. The agent is a lightweight systemd service that runs on your machines, handling the deployment lifecycle of configurations. For more information on the agent, visit the Miru Agent section.

​
Supported platforms

The Miru Agent only supports Linux. MacOS and Windows are not supported. The following operating systems are tested and verified to work with the Miru Agent:
  • Ubuntu 20.04, 22.04, and 24.04 LTS
  • NVIDIA Jetson JetPack 5.1 and JetPack 6.1
  • Raspberry Pi OS (64-bit)
Other Linux distributions and versions may also work, but have not been explicitly tested.

​
Create a device

Navigate to the Devices page.
Click the New Device button in the top right corner. Enter a descriptive name for your device and click Create.

​
Install the agent

Click the Activate button on the device you just created.
A dialog will appear containing a unique, pre-authenticated installation command. Copy this command - you’ll need it in the next step.
The activation token in this install command is short-lived and device-specific. Please don’t share it or reuse it for other devices.
The installation command is composed of several parts:
  • curl -fsSL <installation-script-url> - downloads the installation script from the Miru Agent repository
  • | - pipes the downloaded script to the shell
  • env MIRU_ACTIVATION_TOKEN=<activation-token> - sets the activation token environment variable
  • sh - executes the script with the token
You can review the installation script source code here before running it.
Executing the installation script performs the following actions:
  1. Downloads the agent - fetches the latest Miru Agent Debian package
  2. Installs the service - installs the agent as a systemd service
  3. Activates the device - registers the agent with Miru servers using the activation token
To run the command, open a terminal on the device where you want to install the Miru Agent and paste the installation command.

​
Verify the installation

Upon successful installation, you’ll see a confirmation message in the terminal. 
==> Successfully activated this device as ArcticBlaze!
Navigating back to the Devices page, you should see your device listed with the status Activating before transitioning to Online.
The transition from Activating to Online typically takes 5-15 seconds, depending on your network connection.