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

# Installation

> Install Rumus on macOS, Windows, or Linux.

Rumus is a native desktop app for macOS, Windows, and Linux. All builds are available from [rumus.ai/download](https://www.rumus.ai/download).

## System requirements

<CardGroup cols={3}>
  <Card title="macOS" icon="apple">
    macOS 10.13 (High Sierra) or later<br />
    Apple Silicon and Intel
  </Card>

  <Card title="Windows" icon="windows">
    Windows 10 or later<br />
    x64 and ARM64
  </Card>

  <Card title="Linux" icon="linux">
    Modern distributions<br />
    Requires GTK / WebKit2GTK
  </Card>
</CardGroup>

## Download and install

<Tabs>
  <Tab title="macOS">
    1. Open [rumus.ai/download](https://www.rumus.ai/download) and pick the **Apple Silicon** or **Intel** build that matches your Mac.
    2. Open the downloaded archive and drag **Rumus** into your **Applications** folder.
    3. Authorize the app the first time you launch it.

    ### Authorize the app

    macOS quarantines apps downloaded outside the App Store. You have two ways to allow Rumus to run:

    **Option 1 — Run the `xattr` command (recommended).** Open Terminal and paste:

    ```bash theme={null}
    xattr -cr /Applications/Rumus.app
    ```

    This clears the quarantine attribute on the app bundle. **You'll need to run it again after every update.**

    **Option 2 — Allow through System Settings.** Open **System Settings → Privacy & Security**, scroll to the **Security** section, and click **Open Anyway** next to the message about Rumus.

    <Tip>
      System Settings doesn't always surface the Rumus prompt — especially if you closed the initial dialog. If you can't find it, just run the `xattr` command above.
    </Tip>
  </Tab>

  <Tab title="Windows">
    1. Open [rumus.ai/download](https://www.rumus.ai/download) and pick **x64** or **ARM64** for your machine.
    2. Run the downloaded `.exe` and follow the installer.

    <Note>
      Rumus uses the system **WebView2** runtime to render its UI. Windows 11 and recent Windows 10 builds ship it by default. If your machine doesn't have it, the installer prompts you to install it. You can also install it manually from the [WebView2 download page](https://developer.microsoft.com/en-us/microsoft-edge/webview2/).
    </Note>
  </Tab>

  <Tab title="Linux">
    The fastest way to install Rumus on Linux is the official script. It detects your distribution and architecture and installs the matching package (`.deb`, `.rpm`, or `.AppImage`):

    ```bash theme={null}
    curl -f https://www.rumus.ai/install.sh | sh
    ```

    ### Install manually

    Prefer to grab the package yourself? Each release also offers direct downloads on [rumus.ai/download](https://www.rumus.ai/download):

    | Format      | Architectures | Use for                                               |
    | ----------- | ------------- | ----------------------------------------------------- |
    | `.AppImage` | x64, ARM64    | Any distro — no installation, just `chmod +x` and run |
    | `.deb`      | x64, ARM64    | Debian, Ubuntu, Mint                                  |
    | `.rpm`      | x64, ARM64    | Fedora, RHEL, openSUSE                                |

    AppImage example:

    ```bash theme={null}
    chmod +x rumus.AppImage
    ./rumus.AppImage
    ```

    <Warning>
      Linux builds require `webkit2gtk-4.1` and `libgtk-3`. Most desktop distributions ship these by default; install them with your package manager if Rumus fails to launch.
    </Warning>
  </Tab>
</Tabs>

## Auto-update

Rumus checks for new releases on launch. How updates are applied depends on your platform:

* **macOS and Windows** — when an update is available, Rumus offers to download and install it automatically. You'll see a dialog with options like **Download & Install**, **View Changelog**, or **Visit Download Page**.

  <Note>
    On macOS, remember to run `xattr -cr /Applications/Rumus.app` again after each update.
  </Note>

* **Linux** — auto-install is not supported. Rumus notifies you when a new version is out, and you upgrade by re-running the install script:

  ```bash theme={null}
  curl -f https://www.rumus.ai/install.sh | sh
  ```

  Or by downloading the latest package from [rumus.ai/download](https://www.rumus.ai/download) and installing it through your package manager.

## Uninstall

<Tabs>
  <Tab title="macOS">
    Drag **Applications/Rumus** to the Trash. To wipe local data as well:

    ```bash theme={null}
    rm -rf ~/Library/Application\ Support/ai.rumus.terminal
    rm -rf ~/Library/Caches/ai.rumus.terminal
    ```
  </Tab>

  <Tab title="Windows">
    Open **Settings → Apps → Installed apps**, find Rumus, and uninstall. To clear user data, also remove `%APPDATA%\ai.rumus.terminal`.
  </Tab>

  <Tab title="Linux">
    Use your package manager (`apt remove rumus` / `dnf remove rumus`). For AppImage, just delete the file. User data lives at `~/.config/ai.rumus.terminal`.
  </Tab>
</Tabs>

<Warning>
  Before uninstalling, **back up your vault secret key** if you've enabled vault sync. Without the key, encrypted data in the cloud cannot be recovered. See [Account & Sync](/docs/account/vault) for details.
</Warning>

<Note>
  Have a question we didn't cover? Ask in the [Rumus community](https://www.rumus.ai/community).
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/getting-started/quickstart">
    Sign in, connect a host, and try the AI assistant in five minutes.
  </Card>

  <Card title="Core concepts" icon="diagram-project" href="/docs/getting-started/core-concepts">
    Tabs, Workspaces, the Canvas, Profiles, the Vault, and Agents — explained.
  </Card>
</CardGroup>