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

# Install desktop app

> Install Rainy MaTE BETA 1 on macOS and allow first launch in macOS security settings.

<Warning>
  `BETA 1` is available for `macOS` only. Windows and Linux support is planned for the near future.
</Warning>

## Install from GitHub releases

1. Open [Rainy MaTE Releases](https://github.com/ferxalbs/rainy-mate/releases).
2. Download the latest macOS package.
3. Install and try to launch the app.

Get required keys from the dashboard: [app.rainy-mate.com](https://app.rainy-mate.com).

## macOS security prompt (important for BETA 1)

This beta build is not yet Apple code signed/notarized. macOS may show that the app cannot be opened.

Use this flow to allow it:

1. Try opening Rainy MaTE once from Finder.
2. Open `System Settings -> Privacy & Security`.
3. In the security section, find the blocked app message and click `Open Anyway`.
4. Confirm by clicking `Open` in the follow-up dialog.
5. Launch Rainy MaTE again.

<Info>
  You may need administrator credentials during this process depending on your macOS policy.
</Info>

## First launch checklist

* Confirm the app opens without update errors.
* Add at least one workspace folder.
* Configure and validate one provider key.
* Run a simple task in `Agent Chat`.

## Update strategy for production teams

* Keep all operator desktops on the same release tag.
* Apply updates in a staging workspace first.
* Roll out to production users after validation.

Continue with `/users/first-workflow` after install.