Skip to main content
Before deploying config instances, we must provision a device—the process of installing the Miru Agent onto a machine and registering it with your workspace. The Miru Agent is a lightweight background service (a systemd service on Linux, a Windows service on Windows) that runs on your machines, handling the deployment lifecycle of configurations. For more information on the agent, visit the Miru Agent documentation.

​
Supported platforms

The Miru Agent supports Linux and Windows. macOS is 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 + Device button in the top right corner. Enter a name for your device. Optionally, add a description and choose a group for the device. Then click Create.

​
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. Select the appropriate operating system to continue. If the device already has a compatible Miru Agent installed, you can skip this step.
Follow the instructions to set up Miru’s apt repository and install the miru-agent package. If you’ve already installed the Miru Agent, you can skip these steps.
Provision Dialog for Linux
For more information about installing the miru-agent package, visit the agent installation documentation.

​
Provision the device

Once the miru-agent package is installed, run the provisioning command from the same dialog. The dialog’s provisioning step presents a pre-authenticated command that invokes the miru-agent binary with a short-lived token (5 minutes) to provision the device for your workspace.
The command can be broken into the following components:
  • 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, click Copy command in the dialog and paste the command 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 Miru Agent was successfully installed and provisioned in Miru, navigate to the Devices page. You should see the 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 October 9, 2026