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.

This page details the process of installing the Miru Agent Debian package. It does not cover provisioning devices for your workspace. Visit the device provisioning documentation to learn how to create and register devices with your workspace.

​
Supported platforms

The Miru Agent only supports Linux. MacOS and Windows are not supported. The following operating systems are tested and verified to work with the Miru Agent:
  • Ubuntu 20.04, 22.04, and 24.04 LTS
  • NVIDIA Jetson JetPack 5.1 and JetPack 6.1
  • Raspberry Pi OS (64-bit)
Other Linux distributions and versions may also work, but have not been explicitly tested.

​
Install

The Miru Agent is distributed as a Debian package. Other package formats are not yet supported. We recommend using apt to install the agent. However, you can manually install the package by downloading it from GitHub and installing it with dpkg.
Provisioning tokens require Miru Agent v0.9.0 or later. To install and provision a version that precedes v0.9.0, use the legacy provisioning script instead.
1

Set up

Set up Miru’s apt repository.
# ensure the appropriate dependencies are installed
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# add Miru's signing key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://packages.mirurobotics.com/apt/miru.gpg -o /tmp/miru.gpg.armor
sudo gpg --dearmor -o /etc/apt/keyrings/miru-archive-keyring.gpg /tmp/miru.gpg.armor
rm /tmp/miru.gpg.armor
sudo chmod a+r /etc/apt/keyrings/miru-archive-keyring.gpg

# add the repository to your sources list
sudo tee /etc/apt/sources.list.d/miru.sources > /dev/null <<EOF
Types: deb
URIs: https://packages.mirurobotics.com/apt
Suites: stable
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/miru-archive-keyring.gpg
EOF
2

Install

After configuring the apt repository, install the agent.
sudo apt-get update
sudo apt-get install miru-agent
Install a specific version with sudo apt-get install miru-agent=<version> (e.g. 0.7.0, 0.8.0, etc.).

​
Upgrade

The miru-agent package can be upgraded via apt or by manually downloading the Debian package from GitHub. Since both methods use Debian packages, manual installations can be upgraded via apt and vice versa.
Provisioning tokens require Miru Agent v0.9.0 or later. If you are running a version that precedes v0.9.0, use the legacy provisioning script to provision instead.
Upgrade the existing miru-agent via apt.
sudo apt-get update
sudo apt-get install miru-agent
Upgrade to a specific version with sudo apt-get install miru-agent=<version> (e.g. 0.7.0, 0.8.0, etc.).

​
Uninstall

Remove the Debian package. 
sudo apt-get purge miru-agent
If installed via apt, you can also remove the apt source and keyring. 
sudo rm /etc/apt/sources.list.d/miru.sources 
sudo rm /etc/apt/keyrings/miru-archive-keyring.gpg
sudo rm /var/lib/apt/lists/packages.mirurobotics.com_apt_*
sudo apt-get update
The signing key at /etc/apt/keyrings/miru-archive-keyring.gpg is shared with the Miru CLI. Only remove it if you have also uninstalled the Miru CLI.

​
Poor connectivity

Some environments may have a poor internet connection. Whether located in a remote area or using a cellular connection, downloading the Miru Agent over a network may be impractical in some environments. In such scenarios, we recommend downloading the Miru Agent to a computer with a stable connection. Then, transfer the package to your target machine and install it. While this method circumvents the need to download the Miru Agent over a network, provisioning the agent still requires some level of connectivity to register the device with the Miru control plane.
1

Download the agent

Follow the installation steps and select the Manual tab to download the Miru Agent to a computer with a stable connection.
2

Transfer the agent

Once you’ve downloaded the appropriate Debian package, transfer it to your target machine. This can be done via a variety of methods, such as a USB drive.
3

Install the agent

Once you’ve transferred the package to your target machine, install the miru-agent package by running:
sudo dpkg -i <...>.deb
Last modified on May 18, 2026