Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt

Use this file to discover all available pages before exploring further.

Before deploying config instances, we must provision a device with your workspace—the process of installing the Miru Agent onto a machine and registering it with your workspace. The Miru 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. This getting started guide demonstrates the dashboard. However, you can also use provisioning tokens to provision devices programmatically.

​
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.
Devices Create Page
Click the New Device button in the top right corner. Enter a descriptive name for your device and click Create.
Devices Create Dialog

​
Install the miru-agent package

Next, we need to install the miru-agent package on your target machine. Click the Provision button on the device you just created.
Device to Provision
A dialog will appear prompting you to install the Miru Agent. If the device already has a compatible Miru Agent installed, you can skip this step.
Install Miru Agent Dialog
For more information about installing the miru-agent package, visit the agent installation documentation.

​
Provision the device

Once the miru-agent package is installed, continue to the provisioning step. The dialog will present a pre-authenticated command that invokes the miru-agent binary with a short-lived token (5 minutes) to provision the device for your workspace
Provision Miru Agent Dialog
  • sudo -u miru sets the command to run as the miru user.
  • MIRU_PROVISIONING_TOKEN=<token> authenticates the request.
  • /usr/sbin/miru-agent provision executes the miru-agent binary with the provision command.
To provision the device, copy the command from the dialog and paste it into the terminal of the machine you want to provision.
For more information about Miru’s authentication model, visit the agent security documentation.

​
Verify the installation

To verify the agent was successfully installed and provisioned, navigate to the Devices page. You should see your device listed with the status Activating before transitioning to Online.
The transition from Activating to Online may take up to 10 seconds, depending on your network connection.
Last modified on May 18, 2026