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

# Installing Luumen

> Download and install Luumen on macOS, Windows, or Linux. System requirements, OS-specific install steps, and account setup.

Luumen runs on macOS, Windows, and Linux. This page covers the requirements, installer steps for each platform, and how to sign in after install.

## System requirements

| OS          | Minimum                                                                                       |
| ----------- | --------------------------------------------------------------------------------------------- |
| **macOS**   | macOS 11 Big Sur or later                                                                     |
| **Windows** | Windows 10 (build 1809) or later                                                              |
| **Linux**   | glibc 2.28 or later. Tested on Debian 10+, Ubuntu 20.04+, Fedora 29+, RHEL 8+, OpenSUSE 15.3+ |

<Warning>
  If your operating system is older than the versions listed above, upgrade before installing Luumen.
</Warning>

## Download

Download the installer for your platform from [luumen.ai/download](https://luumen.ai/download).

## Install

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step title="Download the installer">
        Grab the `.dmg` file from [luumen.ai/download](https://luumen.ai/download).
      </Step>

      <Step title="Open the disk image">
        Open the downloaded `.dmg`. A Finder window appears with the Luumen app icon.
      </Step>

      <Step title="Move to Applications">
        Drag the Luumen icon into your **Applications** folder.
      </Step>

      <Step title="Launch">
        Open Luumen from Applications or Spotlight.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows">
    <Steps>
      <Step title="Download the installer">
        Grab the `.msi` file from [luumen.ai/download](https://luumen.ai/download).
      </Step>

      <Step title="Run the installer">
        Double-click the `.msi` and follow the prompts.
      </Step>

      <Step title="Launch">
        Open Luumen from the **Start** menu or desktop shortcut.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux">
    Luumen is distributed as an AppImage. Additional package formats are planned.

    <Steps>
      <Step title="Download the AppImage">
        Grab the `.AppImage` from [luumen.ai/download](https://luumen.ai/download).
      </Step>

      <Step title="Make it executable">
        ```bash theme={null}
        chmod +x Luumen-*.AppImage
        ```
      </Step>

      <Step title="Run">
        ```bash theme={null}
        ./Luumen-*.AppImage
        ```
      </Step>
    </Steps>

    <Tip>
      Move the AppImage to a permanent location such as `~/Applications` or `/opt` so you can launch it more easily.
    </Tip>
  </Tab>
</Tabs>

## Sign in or create an account

Luumen requires a cloud account. There is no local-only mode.

<Steps>
  <Step title="Open Luumen">
    Launch Luumen for the first time. The sign-in screen appears automatically.
  </Step>

  <Step title="Create or sign in">
    Create a new account or sign in to an existing one.
  </Step>

  <Step title="Add your first server">
    Once signed in, the onboarding flow takes you straight into adding your first host.
  </Step>
</Steps>

<Info>
  Signing in is what enables LuumenAI, Skills, shared credentials, and audit logs across every device you sign in on.
</Info>

## Updates

Luumen checks for updates automatically and prompts you in-app when a new version is available. Keep it up to date for the latest features, security patches, and bug fixes.

## Next steps

* [Set up your first SSH connection](/get-started/first-ssh-connection)
* [Learn how Luumen connects](/get-started/how-luumen-connects)