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

# Install & Sign In

> Install the macOS app, authenticate in the browser, and optionally enable Touch ID.

<Card title="Need the shared security model?" icon="lock" href="/fundamentals/v2/overview/security-model">
  Review how Ghostable handles trusted devices and local key material across clients.
</Card>

## Requirements

* macOS 26.2 or later for the current desktop build.
* A Ghostable account with access to at least one organization.

## Install the App

Download the latest Ghostable desktop build from
[ghostable.dev/desktop/download](https://ghostable.dev/desktop/download), then move it into
`Applications` before launching it. That URL always redirects to the current stable desktop release.
The first launch opens the sign-in window.

## Sign In

Click **Continue in browser** in the desktop app. The app opens your default browser so you can
finish authentication with Ghostable or your SSO provider.

After the browser flow completes, the desktop app resumes the session automatically.

## Optional: Touch ID

If Touch ID is available on your Mac, the sign-in window offers **Enable login with Touch ID**. Use
it if you want the app to unlock future sessions without entering credentials again.

<Note>
  Anyone who can unlock your Mac with Touch ID or the device passcode can unlock that local
  Ghostable session too. Treat it as a convenience feature for a trusted workstation.
</Note>

{/* ghostable:screenshot-output desktop-install-sign-in-login-screen:start */}

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/login-screen-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=78e08a4bcf8e67c861a6dc432aee606c" alt="Ghostable desktop sign-in screen showing Continue in browser and Enable login with Touch ID." width="800" height="924" data-path="images/generated/screenshots/ghostable-desktop/login-screen-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/login-screen-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=47f8db402962f52f958e072d8cbd8d9c" alt="Ghostable desktop sign-in screen showing Continue in browser and Enable login with Touch ID." width="800" height="924" data-path="images/generated/screenshots/ghostable-desktop/login-screen-dark.png" />

## What Happens Next

After sign-in, Ghostable checks whether this Mac has already been linked as a trusted device. If it
has not, the app opens the device-link flow immediately.

## Continue

<CardGroup>
  <Card title="Link your device" icon="laptop" href="/desktop/v1/getting-started/link-your-device">
    Register the Mac before you try to read or change encrypted environments.
  </Card>

  <Card title="Tour the interface" icon="table" href="/desktop/v1/getting-started/interface-tour">
    Learn where projects, environments, and app settings live after sign-in.
  </Card>
</CardGroup>
