> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/desktop-app.md).

# Desktop App

Run Silkline as its own app on Mac, Windows, or Linux. Download it, sign in, and learn when Shop requires it.

The Silkline desktop app runs Silkline in its own window, separate from your web browser. Quotes, orders, approvals, and everything else work the same as on [app.silkline.ai](https://app.silkline.ai). The app also runs [Shop](https://docs.silkline.ai/shop.md) sessions directly, and it updates itself in the background.

{% hint style="success" %}
We recommend the desktop app for Shop. Sessions start faster and are less prone to login and cart-extraction issues. See [The Silkline desktop app](https://docs.silkline.ai/shop/using-shop.md#the-silkline-desktop-app) for how Shop works in the app.
{% endhint %}

## Download and install

The quickest way is from your **Account** page. Click your name in the lower left of Silkline, then click **Download Silkline** under **Desktop App**. Silkline detects your operating system and downloads the right installer.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-0b93ce7401207ed568f3cfb7535a91f1b9d64a91%2Fdesktop-account-card.png?alt=media" alt="Desktop App section on the Account page with a Download Silkline button and an Other platforms link" width="640"><figcaption></figcaption></figure>

For a different operating system, click **Other platforms** to open [app.silkline.ai/desktop](https://app.silkline.ai/desktop) and pick one:

| Platform | Supported versions      |
| -------- | ----------------------- |
| Mac      | Apple Silicon and Intel |
| Windows  | 64-bit                  |
| Linux    | AppImage and `.deb`     |

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-a335b589156e8cb7e5378f12a2e739dd3e601255%2Fdesktop-download-page.png?alt=media" alt="Silkline desktop download page with a Download for your device button and Mac, Windows, and Linux options" width="720"><figcaption></figcaption></figure>

Open the downloaded installer and follow the prompts.

{% hint style="info" %}
The **Desktop App** section only appears on the Account page in a web browser. It's hidden when you're already using the desktop app.
{% endhint %}

## Sign in

The desktop app signs you in through your default web browser, so your organization's single sign-on, multi-factor, and passkey requirements apply as usual.

{% stepper %}
{% step %}

### Start in the app

Open Silkline and choose how to sign in, the same as on the web. The app shows **Continue in your browser** and opens your default browser.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-65c80033709413abe92c6962f82801e8d449ccce%2Fdesktop-sign-in-continue.png?alt=media" alt="Desktop app sign-in screen reading Continue in your browser, with a Start over link" width="480"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Finish in your browser

Complete sign-in in the browser tab that opened. When you're done, the tab shows **Returning to Silkline** and the app comes back to the front. If it doesn't, click **Return to the Silkline app** in that tab.
{% endstep %}

{% step %}

### Close the tab

You're signed in to the app. You can close the browser tab.
{% endstep %}
{% endstepper %}

A sign-in attempt expires after 5 minutes. To start again, click **Start over** in the app.

## When the desktop app is required

Most of Silkline works in either the browser or the desktop app. Shop needs the desktop app in these cases:

* **Digi-Key.** Shop for Digi-Key runs only in the desktop app.
* **FedRAMP and ITAR organizations.** Every Shop session runs in the desktop app. Launching any supplier from the browser is declined.

In those cases the browser shows a message such as **Shop for Digi-Key is only available in the Silkline desktop app**. Install the app and start the session from there.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-c0c7de9a3068d145e8c3829aca9ac1b10a975f7c%2Fdesktop-shop-desktop-only.png?alt=media" alt="Shop page in a browser with the Digi-Key Shop button disabled and a tooltip reading Shop for Digi-Key is only available in the Silkline desktop app" width="720"><figcaption></figcaption></figure>

## Next steps

* [Using the Desktop App](https://docs.silkline.ai/desktop-app/using-the-desktop-app.md): windows, navigation, menus, and supplier logins.
* [Updates & Troubleshooting](https://docs.silkline.ai/desktop-app/updates-and-troubleshooting.md): keeping the app current and fixing sign-in or launch problems.
