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

# Installation

> Where to download each Mauvely app, what the installer does, and how updates are delivered on Windows and Linux.

Downloads live on [mauvely.com](https://mauvely.com). What is available today differs by app, so
this page is organised that way rather than by platform.

<Note>
  **Mauvely Snap has no installer yet.** It is at an early version with no release pipeline, so
  there is nothing to download. See the [Snap roadmap](/snap/roadmap).
</Note>

## Mauvely Compose

<Tabs>
  <Tab title="Windows">
    Download `MauvelyCompose-<version>-windows-x86_64.msi` and run it.

    The installer is **per-user**: Compose is installed into your own `%LOCALAPPDATA%` rather than
    `Program Files`. Two consequences worth knowing:

    * It never asks for administrator rights, and neither do updates.
    * Each Windows account on the machine installs its own copy.

    <Tip>
      A per-user install is what makes silent background updates possible. A per-machine install
      would raise a Windows UAC prompt for every update.
    </Tip>
  </Tab>

  <Tab title="Linux">
    Download `MauvelyCompose-<version>-linux-x86_64.AppImage`, make it executable, and run it:

    ```bash theme={null}
    chmod +x MauvelyCompose-*-linux-x86_64.AppImage
    ./MauvelyCompose-*-linux-x86_64.AppImage
    ```

    An AppImage is self-contained — there is nothing to install and nothing to uninstall. Delete
    the file to remove it.

    <Note>
      The AppImage bundles the browser engine that drives the learner preview. If you build Compose
      yourself instead, and Qt WebEngine is missing, everything still works except the preview,
      which shows a placeholder.
    </Note>
  </Tab>
</Tabs>

### First launch

Compose asks you to sign in before it opens. Sign-in happens in your **browser**, not in the app —
see [Accounts](/get-started/accounts) for why, and for what happens when you are offline.

After signing in you land on the welcome screen, not in a course: recent courses and the news feed
on one side, **New course**, **From a template** and **Open** on the other.

### Updates

Compose checks for updates a few seconds after launch and every six hours after that.

| Platform                              | Behaviour                                                                          |
| ------------------------------------- | ---------------------------------------------------------------------------------- |
| Windows                               | Downloads in the background, verifies it, then offers **Update ready — restart**.  |
| Linux, AppImage                       | Same: downloads, verifies, replaces the image in place on restart.                 |
| Linux, installed by a package manager | Notifies you and links to the download page. Your package manager owns the update. |

Every download is checked against a SHA-256 published alongside it, and a file that does not match
is discarded rather than offered. A failed check — no network, service down — is silent by design;
it never interrupts you with a dialog.

You can turn the startup check off in **Settings ▸ Advanced ▸ Updates**.

## Mauvely Cloud

Nothing to install. Open [cloud.mauvely.com](https://cloud.mauvely.com) in any modern browser and
sign in with your Mauvely account.

The first time you open it you are asked to set up a **vault** — this creates your encryption keys
and gives you a 24-word recovery phrase. Do not skip it, and do not skip writing the phrase down;
it is one of only two things that can ever open your files.

See [Setting up your vault](/cloud/setting-up-your-vault).

## Sotto

Sotto is Linux only and ships as a single AppImage:

```bash theme={null}
chmod +x Sotto-x86_64.AppImage
./Sotto-x86_64.AppImage
```

There is no Flathub package and no `.deb`, `.rpm` or AUR package. Building from source lets you
choose a GPU backend, which materially affects transcription speed — see
[Installing Sotto](/sotto/installing) for both routes and the desktop requirements.

On first launch Sotto opens its Settings window so you can download a speech model. Nothing works
until one is installed.

## Mauvely Snap

Not yet available. Snap is an early build with no packaging or release pipeline, so there is no
installer to download on any platform. When it ships it will be **Windows first**; the Linux build
exists but is deliberately not distributed, because a Wayland client is not allowed to read the
screen and the resulting product would be materially different.

[What is built, and what is not →](/snap/roadmap)