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

# Desktop app

> Download, sign in, update, and understand offline behavior.

Mana is available in the browser and as a desktop app.

The desktop app uses the same account and projects as the web app.

## Download

Use the download link from the website or the account menu inside Mana.

Current desktop builds are available for macOS on Apple Silicon and Intel,
Windows on x86\_64, and Linux on x86\_64 and ARM64.

Linux is distributed as an AppImage. Download the build matching your processor
architecture, mark the file as executable, and launch it:

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

## Sign in on desktop

The desktop app signs you in through your system browser.

<Steps>
  <Step title="Open the desktop app">
    Choose **Log In**.
  </Step>

  <Step title="Sign in in the browser">
    Complete the normal Mana sign-in flow, then confirm **Continue as…** on the desktop authorization page.
  </Step>

  <Step title="Return to the app">
    The browser sends you back to the desktop app with a one-time sign-in link.
  </Step>
</Steps>

## Updates

The desktop app checks for updates automatically.

On startup, an available update may download and install immediately. While the app is already open, Mana can download updates in the background and show an update indicator when one is ready to install.

## Offline behavior

Mana is not a full offline-first editor.

Brief connection drops are buffered locally while the editor reconnects. If the app stays disconnected for several seconds, Mana shows a blocking reconnect dialog so you do not keep writing for a long time against a connection that cannot persist your work.

<Warning>
  Do not treat the desktop app as a long-term offline writing mode. Closing the app during an extended disconnect can lose changes that have not reached the server.
</Warning>

## Connection status

The editor footer shows whether Mana is online or reconnecting. On editor pages, the status also accounts for the live editor connection.