Skip to main content
Provisioning a device is the process of creating a device in Miru and registering a physical machine with the Miru control plane. Once provisioned, a device is ready to receive deployments.

​
Methods

There are four methods for provisioning a device:
  1. Dashboard - a manual method for provisioning devices one at a time via the Miru web interface; great for getting started or managing individual devices.
  2. Provisioning tokens - a programmatic method for securely provisioning devices at scale; great for automated provisioning or integrating with existing infrastructure management tools and workflows.
  3. Ansible - install the agent and provision a fleet with the official Ansible collection; great for teams that already manage devices with Ansible.
  4. Provisioning script - the legacy method for programmatically provisioning devices; unsupported with Miru Agent v0.9.0 or later.

​
Miru Agent installation

No matter which method you choose, the device requires the miru-agent package to be installed. The official Ansible collection installs the agent as part of the provisioning process. For more information about installing the miru-agent package, visit the agent installation documentation. If you’re having trouble downloading the miru-agent package to your device, refer to the poor connectivity documentation for a workaround. Once you’ve installed the miru-agent package, proceed with the provisioning process via the dashboard or provisioning tokens.

​
Reprovisioning

Reprovisioning a device is the process of reassociating a physical device with a device in Miru. Reprovisioning a device fully maintains the device’s deployment history in Miru, even if reprovisioning occurs on a different physical device. Visit the reprovisioning documentation for more information.

​
Authentication model

If you’re curious about Miru’s authentication model, please consult the agent security documentation.
Last modified on September 23, 2026