Install

This page details how to install the Miru Agent. 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. For Ansible users, we recommend using the Ansible collection to install the agent and provision a fleet together.

Supported platforms

The Miru Agent supports Linux and Windows. macOS is not supported.

Linux
Windows

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.

Linux
Windows

The Miru Agent is distributed as a Debian package.We recommend using apt to install the agent. However, you can manually install the agent by downloading it from GitHub and installing it with dpkg.

APT
Manual

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

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.).

Download

All Miru Agent releases are available as Debian packages on GitHub. You can find the latest release here.To download the agent, drop down the Assets section for the desired release and select the .deb package for your architecture.For example, if your robot is an x86_64 machine, you’ll want to download miru-agent_<version>_amd64.deb. If your robot is an aarch64 machine, you’ll want to download miru-agent_<version>_arm64.deb.

Install

After downloading the package, install it using dpkg.

sudo dpkg -i <...>.deb

The Miru Agent for Windows is distributed as an MSI installer.Windows is only supported for Miru Agent v0.11.0 and later. Earlier releases do not include an MSI installer.

Manual
Programmatic

Download

Find your desired release version from the releases page on GitHub, expand the Assets section, and download miru-agent-<version>.msi.

Install

Double-click the MSI in your Downloads folder and follow the installer. It registers and starts the miru-agent Windows service.

Download

Find your desired release version from the releases page on GitHub, expand the Assets section, and download miru-agent-<version>.msi.

Install

Open PowerShell with Run as administrator and run the installer, replacing the paths with your own.

msiexec /i "C:\path\to\miru-agent-<version>.msi" `
  /qn `
  /norestart `
  /l*v "C:\path\to\miru-agent-install.log" | Out-Null

$LASTEXITCODE is 0 when the agent is installed. 3010 means the agent is installed and Windows must be restarted. For any other exit code, check the log file.

Upgrade

Linux
Windows

The miru-agent package can be upgraded via apt or by manually downloading the Debian package from GitHub.

APT
Manual

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.).

Run the install command with a newer MSI. The installer upgrades in place and keeps %ProgramData%\Miru, so the device stays provisioned.Installing an older MSI over a newer version fails. To downgrade, you must first uninstall the agent and then install the older version.

Uninstall

Linux
Windows

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.

Manual
Programmatic

Uninstall the Miru Agent from Settings > Apps > Installed apps.

Open PowerShell with Run as administrator and run the following. It looks up the installed Miru Agent and uninstalls it silently, so you don’t need the original MSI.

PowerShell

$app = @(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" | Where-Object DisplayName -eq "Miru Agent"); `
if ($app.Count -ne 1) { throw "Expected one Miru Agent installation, found $($app.Count)" }; `
msiexec /x $app[0].PSChildName /qn /norestart | Out-Null; `
$LASTEXITCODE

$LASTEXITCODE is 0 when the agent is uninstalled. 3010 means the agent is uninstalled and Windows must be restarted. If the Miru Agent isn’t installed, the command stops with an error before running msiexec.

Uninstalling keeps %ProgramData%\Miru, which holds the agent’s settings, device identity, keys, and logs, and the Miru Agent Users group and its members. For a complete removal, delete both after uninstalling the agent.Deleting %ProgramData%\Miru also deletes %ProgramData%\Miru\configs, the default location of deployed configs, so back up any configs your applications still read first.

PowerShell

Remove-Item -Recurse -Force "$env:ProgramData\Miru"; `
Remove-LocalGroup "Miru Agent Users"

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.

Linux
Windows

Download the agent

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

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.

Install the agent

Once you’ve transferred the package to your target machine, install the miru-agent package by running:

sudo dpkg -i <...>.deb

Welcome

Fleet

Config Management

Data Uploads

Developers

Administration

Install

Supported platforms

Install

Upgrade

Uninstall

Poor connectivity

​Supported platforms

​Install

​Upgrade

​Uninstall

​Poor connectivity

Supported platforms

Install

Upgrade

Uninstall

Poor connectivity