> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira-app.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux Installation

> Install MIRA on Ubuntu 20.04+, Fedora 36+, or any x64 Linux distribution.

## Requirements

| Requirement          | Detail                                                               |
| -------------------- | -------------------------------------------------------------------- |
| **Distribution**     | Ubuntu 20.04+, Fedora 36+, or any modern x64 Linux                   |
| **Architecture**     | x64 (amd64)                                                          |
| **Python**           | Bundled — no separate install needed                                 |
| **LLM provider**     | One of: AWS Bedrock, Anthropic, OpenAI, or Ollama                    |
| **Disk space**       | \~500 MB (includes bundled Python runtime)                           |
| **keychain backend** | `libsecret` (GNOME) or `KWallet` (KDE) for secure credential storage |

## Download

Go to [github.com/satyendra2013/mira-app/releases/latest](https://github.com/satyendra2013/mira-app/releases/latest) and download one of:

* **`MIRA-x.x.x-x64.AppImage`** — runs on any x64 Linux, no install required
* **`mira_x.x.x_amd64.deb`** — Debian/Ubuntu system install
* **`mira-x.x.x-x86_64.rpm`** — Fedora/RHEL/openSUSE system install

## Install

<Tabs>
  <Tab title="AppImage (any distro)">
    ```bash theme={null}
    # Make executable and run — no install, no root required
    chmod +x MIRA-x.x.x-x64.AppImage
    ./MIRA-x.x.x-x64.AppImage
    ```

    To add to your application launcher, place the AppImage in `~/.local/bin/` and create a
    `.desktop` file, or use [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher).
  </Tab>

  <Tab title="Debian / Ubuntu (.deb)">
    ```bash theme={null}
    # Install
    sudo dpkg -i mira_x.x.x_amd64.deb

    # Fix any missing dependencies
    sudo apt-get install -f

    # Launch
    mira
    ```
  </Tab>

  <Tab title="Fedora / RPM (.rpm)">
    ```bash theme={null}
    # Fedora
    sudo dnf install mira-x.x.x-x86_64.rpm

    # RHEL / openSUSE
    sudo rpm -i mira-x.x.x-x86_64.rpm

    # Launch
    mira
    ```
  </Tab>
</Tabs>

## Credential storage on Linux

MIRA uses `libsecret` to store secrets (API keys, AWS credentials) in your system keyring:

* **GNOME:** GNOME Keyring (installed by default on Ubuntu, Fedora GNOME)
* **KDE:** KWallet

If neither is available (e.g. on a headless or minimal install), credentials fall back to an encrypted file. Ensure `libsecret` is installed:

```bash theme={null}
# Ubuntu / Debian
sudo apt-get install libsecret-1-0

# Fedora
sudo dnf install libsecret
```

## First launch

MIRA performs a one-time setup on first launch:

* Creates a Python virtual environment at `~/.config/MIRA/mira-venv/`
* Installs all required Python packages from the bundled `requirements.txt`

A splash screen is displayed during this step (\~60 seconds). The status bar shows `NAE starting…` → `NAE ready` when complete.

## Data location

All MIRA data is stored locally at:

```
~/.config/MIRA/
├── mira.db          ← sessions, skills, workflows, settings
├── evals.db         ← evaluation runs and results
├── credentials.json ← encrypted credentials (libsecret/safeStorage)
├── mira-venv/       ← Python environment
└── logs/            ← application logs (credentials redacted)
```

## Uninstall

```bash theme={null}
# AppImage — delete the file and optionally the data directory
rm ~/path/to/MIRA-x.x.x-x64.AppImage
rm -rf ~/.config/MIRA/

# Deb package
sudo apt-get remove mira
rm -rf ~/.config/MIRA/    # removes data and credentials (not done by package manager)

# RPM package
sudo dnf remove mira      # Fedora
sudo rpm -e mira          # RHEL/openSUSE
rm -rf ~/.config/MIRA/    # removes data and credentials
```

***

## Updating

MIRA checks for updates shortly after launch. When a new version is available, an in-app notification shows the available version number. Go to [github.com/satyendra2013/mira-app/releases/latest](https://github.com/satyendra2013/mira-app/releases/latest) to download the latest AppImage, `.deb`, or `.rpm` and install as above.

***

<Note>
  **Edit this page** — [Open a pull
  request](https://github.com/satyendra2013/mira-app/edit/main/docs/get-started/installation/linux.mdx)
  to improve these instructions.
</Note>