Skip to main content
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.
Reprovisioning requires Miru Agent v0.9.0 or later. For older agents, Reprovision is disabled; upgrade the agent first.
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

If the machine doesn’t have the miru-agent package installed (for example, a new machine or a clean reinstall), install it first by following the agent installation documentation.

​
Reprovision the device

Once the miru-agent package is installed, run the reprovisioning command from the dialog. If you closed the dialog, select Reprovision from the device’s ellipsis menu again. 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. Select the appropriate operating system.
Reprovision Dialog for Linux
The command can be broken into the following components:
  • 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, click Copy command in the dialog and paste the command 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 October 9, 2026