> ## 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.
# Devices
export const ViewerBadge = ({size = "md"}) => {
return
viewer
;
};
export const ProvisionerBadge = ({size = "md"}) => {
return
provisioner
;
};
export const AdminBadge = ({size = "md"}) => {
return
admin
;
};
export const PlatformApiLink = ({endpoint, newTab, children}) => {
const href = `/references/platform-api/2026-05-06/endpoints/${endpoint}`;
if (newTab) {
return {children};
}
return {children};
};
export const Framed = ({image, background, link, alt = "Framed content", borderWidth = "24px", outerRadius = "10px", innerRadius = "6px"}) => {
const parseShorthand = value => {
const values = String(value).trim().split(/\s+/);
switch (values.length) {
case 1:
return [values[0], values[0], values[0], values[0]];
case 2:
return [values[0], values[1], values[0], values[1]];
case 3:
return [values[0], values[1], values[2], values[1]];
default:
return values.slice(0, 4);
}
};
const isZero = v => parseFloat(v) === 0;
const padding = parseShorthand(borderWidth);
const outer = parseShorthand(outerRadius);
const cornerMasks = [];
if (isZero(padding[0]) && isZero(padding[3])) {
cornerMasks.push(`radial-gradient(circle at 0% 0%, transparent ${outer[0]}, black ${outer[0]})`);
}
if (isZero(padding[0]) && isZero(padding[1])) {
cornerMasks.push(`radial-gradient(circle at 100% 0%, transparent ${outer[1]}, black ${outer[1]})`);
}
if (isZero(padding[2]) && isZero(padding[1])) {
cornerMasks.push(`radial-gradient(circle at 100% 100%, transparent ${outer[2]}, black ${outer[2]})`);
}
if (isZero(padding[2]) && isZero(padding[3])) {
cornerMasks.push(`radial-gradient(circle at 0% 100%, transparent ${outer[3]}, black ${outer[3]})`);
}
const backgroundMask = cornerMasks.length > 0 ? cornerMasks.join(", ") : undefined;
const innerImage = 
;
return ;
};
export const NullableBadge = ({size = "sm"}) => {
return
nullable
;
};
export const EditableBadge = ({size = "sm"}) => {
return
editable
;
};
export const MutableBadge = ({size = "sm"}) => {
return
mutable
;
};
export const OFFLINE_TOOLTIP = {
tip: "Device has lost connection with Miru's servers",
cta: "Learn more",
href: "/learn/devices/overview#status"
};
export const ONLINE_TOOLTIP = {
tip: "Device is connected to Miru's servers",
cta: "Learn more",
href: "/learn/devices/overview#status"
};
A **device** is a machine to which config instances are deployed. This could be an NVIDIA Jetson, Raspberry Pi, industrial PC, or any other computer running your robot's application.
Configurations are deployed to devices via the Miru Agent, a lightweight `systemd` service that runs on your devices, handling the deployment lifecycle of configurations. Visit the [Miru Agent](/developers/agent/overview) documentation for more information.
## Properties
A human-readable display name that can contain most characters, such as spaces, special characters, and punctuation. Must contain between 1 and 48 characters.
Examples: `Robot 11`, `ArcticBlaze`, `Warehouse Rover`
The [status](#status) of the device.
Allowed values:
* `inactive`
* `activating`
* `online`
* `offline`
{' '}
The timestamp of when the device last connected to Miru's servers.
Examples: `2026-05-25T12:00:00Z`
{' '}
The timestamp of when the device last disconnected from Miru's servers.
Examples: `2026-05-25T12:00:00Z`
{' '}
The version of the Miru Agent running on the device.
The agent version exists only if the device has a status of `online` or `offline`. If the device is `inactive` or `activating`, the agent version is `null`.
Examples: `v0.6.0`
{' '}
The [release](/primitives/releases#properties) to which the device's current deployment belongs.
If the device is `inactive` or `activating`, the current release id is `null`. If the device is `online` or `offline`, the current release may still be `null` if the device has no deployed config instances.
Examples: `rls_123`
{' '}
The [group](/primitives/groups#properties) to which the device belongs. If the device's group is not set, the group id is `null`.
Examples: `grp_123`
## Status
Devices leverage several states to track their registration and connectivity with the Miru control plane.
| Status | Description |
| ------------ | ----------------------------------------------------------- |
| `inactive` | The Miru Agent has not yet been installed and authenticated |
| `activating` | The Miru Agent is registering itself with Miru's servers |
| `online` | Device is currently connected to Miru's servers |
| `offline` | Device has lost connection to Miru's servers |
Devices begin in the `inactive` state. During the Miru Agent install process, devices briefly enter the `activating` state before transitioning to `online`.
Once the Miru Agent has been provisioned on a device, the device remains `online` or `offline` for the remainder of its existence—devices don't transition back to `inactive` or `activating`.
The only exception to this is when a device is [reprovisioned](/cfg-mgmt/provision-devices/reprovision). During reprovisioning, devices briefly enter the `activating` state before transitioning back to `online`.
To view a device's status, hover over its name on the Devices page.
## View a device
To view a device in Miru, navigate to the [Devices page](https://app.mirurobotics.com/devices), click into the device you want to view, and switch to the **Overview** tab at the top.
**Metadata**
At the top of the page, you'll find the device's metadata, including its name, status, agent version, and more.
**Audit trail**
At the bottom of the page, you'll find a complete audit trail of deployments made to the device.
## Provision a device
To provision a device, visit the [device provisioning](/cfg-mgmt/provision-devices/overview) .
## Edit a device
**Dashboard**
Navigate to the [Devices page](https://app.mirurobotics.com/devices), click the ellipses (...) on the device you want to edit, and hit **Edit**.
Update the desired fields, then click **Save**.
**Platform API**
To edit a device programmatically, use the update device endpoint »
## Ping a device
Pinging a device sends a real-time request to verify whether it is online. Ping requests wait up to 5 seconds for a response from the device before timing out.
Online devices should return a success message similar to the one below.
On the other hand, offline devices should return a timeout message similar to the one below.
## Move a device
To move a device to a different group, click the ellipses (...) on the device you want to move and select **Move**.
A dialog will appear—select the group you want to move the device to and hit **Move**.
## Delete a device
Deleting a device immediately invalidates its authentication session and removes all deployment and configuration history. This action is irreversible. Please proceed with caution.
**Dashboard**
To delete a device, click the ellipses (...) on the device you want to delete and hit **Delete**.
A confirmation dialog will appear—click **Delete** to confirm.
