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

# Installation

> Download and install Runner on macOS, Windows, or Linux in about two minutes.

Runner is a desktop app. Download it, open it, and you're ready to go.

## Download Runner

Head to [runner.now](https://runner.now) and grab the version for your computer.

<CardGroup cols={3}>
  <Card title="macOS" icon="apple">
    Works on both Intel and Apple Silicon Macs. Requires macOS 12 or later.
  </Card>

  <Card title="Windows" icon="windows">
    Works on 64-bit Windows 10 or later.
  </Card>

  <Card title="Linux" icon="linux">
    Available as AppImage and .deb. Ubuntu 22.04+ recommended.
  </Card>
</CardGroup>

***

## Install on macOS

<Steps>
  <Step title="Download">
    Go to [runner.now](https://runner.now) and click **Download for Mac**. A `.dmg` file will land in your Downloads folder.
  </Step>

  <Step title="Install">
    Double-click the file and drag Runner into your Applications folder.
  </Step>

  <Step title="Open Runner">
    Launch it from Applications or Spotlight (`Cmd + Space`, type "Runner").

    If your Mac shows a security warning, go to **System Settings > Privacy & Security** and click **Open Anyway**.
  </Step>

  <Step title="Sign in">
    Sign in with your Google account. You'll land in your first workspace, ready to connect apps and start working.
  </Step>
</Steps>

***

## Install on Windows

<Steps>
  <Step title="Download">
    Go to [runner.now](https://runner.now) and click **Download for Windows**.
  </Step>

  <Step title="Install">
    Double-click the `.exe` file and follow the prompts. No admin permissions needed — it installs to your user profile.
  </Step>

  <Step title="Open Runner">
    Runner opens automatically after installation. You'll also find it in your Start menu.
  </Step>

  <Step title="Sign in">
    Sign in with your Google account and you're good to go.
  </Step>
</Steps>

<Note>
  If Windows Defender SmartScreen shows a warning, click **More info** then **Run anyway**. Runner is signed, but new apps sometimes trigger this.
</Note>

***

## Install on Linux

<Steps>
  <Step title="Download">
    Go to [runner.now](https://runner.now) and choose either the **AppImage** (runs anywhere) or the **.deb** package (for Ubuntu/Debian).
  </Step>

  <Step title="Install">
    **AppImage:** Make it runnable and open it.

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

    **.deb:** Install with your package manager.

    ```bash theme={null}
    sudo dpkg -i runner-*.deb
    ```
  </Step>

  <Step title="Open Runner">
    Find Runner in your application launcher, or run it from the terminal.
  </Step>

  <Step title="Sign in">
    Sign in with your Google account.
  </Step>
</Steps>

***

## What's next?

Once Runner is open:

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Connect your first app and see Runner in action. Four steps, a few minutes.
  </Card>

  <Card title="Connect your apps" icon="plug" href="/get-started/connecting-accounts">
    See everything Runner connects to: Gmail, Calendar, Slack, and more.
  </Card>
</CardGroup>

***

## Common issues

<AccordionGroup>
  <Accordion title="Runner won't open on macOS">
    Go to **System Settings > Privacy & Security**, scroll down, and click **Open Anyway** next to the Runner message.
  </Accordion>

  <Accordion title="Windows shows a SmartScreen warning">
    Click **More info** then **Run anyway**. This happens with new apps — Runner is safe to install.
  </Accordion>

  <Accordion title="Missing dependencies on Linux">
    If Runner won't launch, try installing these:

    ```bash theme={null}
    sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6
    ```
  </Accordion>

  <Accordion title="First launch is slow">
    The first time you open Runner it sets up your local environment. Totally normal. After that, it opens fast.
  </Accordion>
</AccordionGroup>