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

# Install

## Install

The CLI is only available on macOS and Linux. Windows is not supported.

<Tabs>
  <Tab title="macOS">
    Install via Homebrew.

    ```bash theme={null}
    brew install mirurobotics/cli/miru
    ```

    <Info>
      If you are not seeing the latest CLI version, refresh Homebrew with `brew update`.
    </Info>
  </Tab>

  <Tab title="Linux">
    The CLI is distributed to Linux as a Debian package. Other package formats are not yet supported.

    We recommend using `apt` to install the CLI. However, you can manually install the Debian package by downloading it from GitHub and installing it with `dpkg`.

    <Tabs>
      <Tab title="APT">
        <Steps>
          <Step title="Set up">
            Set up Miru's `apt` repository.

            ```bash theme={null}
            # 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
            ```
          </Step>

          <Step title="Install">
            After configuring the `apt` repository, install the CLI.

            ```bash theme={null}
            sudo apt-get update
            sudo apt-get install miru-cli
            ```

            <Tip>
              Install a specific version with `sudo apt-get install miru-cli=<version>` (e.g. `0.9.1`, `0.10.0`, etc.).
            </Tip>
          </Step>
        </Steps>
      </Tab>

      <Tab title="Manual">
        <Steps>
          <Step title="Download">
            All Miru CLI releases are available as Debian packages [on GitHub](https://github.com/mirurobotics/cli/releases). You can find the latest release [here](https://github.com/mirurobotics/cli/releases/latest).

            To download the CLI, drop down the **Assets** section for the desired release. The assets ending with the `.deb` extension are the Debian packages for the Miru CLI.

            <Frame>
              <img src="https://assets.mirurobotics.com/docs/v04/images/cli/github-assets.light.png" alt="GitHub release assets" className="block dark:hidden" />

              <img src="https://assets.mirurobotics.com/docs/v04/images/cli/github-assets.dark.png" alt="GitHub release assets" className="hidden dark:block" />
            </Frame>

            Find the architecture that matches your target machine's architecture and download the package.

            For example, if your robot is an `x86_64` machine, you'll want to download the `miru-cli_<version>_amd64.deb` package. If your robot is an `aarch64` machine, you'll want to download the `miru-cli_<version>_arm64.deb` package.
          </Step>

          <Step title="Install">
            After downloading the package, install it using `dpkg`.

            ```bash theme={null}
            sudo dpkg -i <...>.deb
            ```
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

## Verify

To verify the CLI is installed and up to date, run the `miru version` command.

```bash theme={null}
$ miru version
Version: 0.10.0
Commit: 76b320c4ecec7a8e4b12cabb635831a4ad1d5d28
Built: 2026-04-20T02:54:55Z
```

You can find the CLI release changelog in the [CLI changelog](/changelog/cli).

## Upgrade

To upgrade the Miru CLI to the latest version, run the upgrade command in your local machine's terminal.

<Tabs>
  <Tab title="macOS">
    ```bash theme={null}
    brew upgrade mirurobotics/cli/miru
    ```

    <Info>
      If you are not seeing the latest CLI version, refresh Homebrew with `brew update`.
    </Info>
  </Tab>

  <Tab title="Linux">
    You can upgrade the CLI via `apt` or by manually downloading the package from GitHub. Since both methods use Debian packages, manual installations can be upgraded via `apt` and vice versa.

    <Tabs>
      <Tab title="APT">
        ```bash theme={null}
        sudo apt-get update
        sudo apt-get install miru-cli
        ```

        <Tip>
          Upgrade to a specific version with `sudo apt-get install miru-cli=<version>` (e.g. `0.9.1`, `0.10.0`, etc.).
        </Tip>
      </Tab>

      <Tab title="Manual">
        Manual installations do not have a native upgrade mechanism. Simply repeat the [installation steps](#install) to upgrade to the latest version.
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

## Uninstall

<Tabs>
  <Tab title="macOS">
    Remove via Homebrew.

    ```bash theme={null}
    brew uninstall miru
    ```
  </Tab>

  <Tab title="Linux">
    Remove the Debian package.

    ```bash theme={null}
    sudo apt-get purge miru-cli
    ```

    If installed via `apt`, you can also remove the apt source.

    ```bash theme={null}
    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
    ```

    <Info>
      The signing key at `/etc/apt/keyrings/miru-archive-keyring.gpg` is shared with the Miru Agent. Only remove it if you have also uninstalled the Miru Agent.
    </Info>
  </Tab>
</Tabs>

Remove any leftover configuration files.

```bash theme={null}
rm -rf ~/.miru
```