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.

Reprovisioning a device is the process of reassociating a physical machine with a Miru device. This can be the same physical machine that the Miru device was initially provisioned on, or a different physical machine. Reprovisioning a Miru device does the following:
  1. Invalidates the device’s current authentication session.
  2. Creates a new authentication session for the device.
  3. Redeploys the device’s current deployment.
If you reprovision a Miru device on a different physical machine, the old machine’s authentication session is immediately invalidated and no longer connected to your workspace. Reprovisioning fully maintains the device’s deployment history in Miru. After reprovisioning, the device’s deployment history picks up where it left off before reprovisioning occurred.

​
Use cases

Reprovisioning a device is useful for:
  • Removing the miru-agent and cleanly reinstalling it
  • Transferring a Miru device to a different physical machine
Reprovisioning is NOT meant to be used to upgrade the miru-agent package. If you simply want to upgrade the miru-agent package, follow the Miru Agent upgrade documentation.

​
Dashboard

Reprovisioning a device is only supported via the Miru dashboard. Support for programmatically reprovisioning devices is coming soon. To reprovision a device, click the ellipsis (…) next to the device you want to reprovision, then select Reprovision.
Reprovision device dropdown

​
Install the miru-agent package

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.

​
Reprovision the device

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