Skip to main content
The Miru dashboard is the simplest method for provisioning a device, ideal for getting started or managing individual devices. For automated provisioning, use provisioning tokens or the Ansible collection.

​
Create a device

If you don’t yet have a device in Miru, you’ll need to create one. 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

Click the Provision button on the device you want to provision.
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