> 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/updates-and-troubleshooting.md).

# Updates & Troubleshooting

Keep the Silkline desktop app up to date and fix common sign-in and Shop launch problems.

## Keeping the app up to date

The desktop app checks for updates when it starts and every few minutes while it's open. Updates download in the background.

* When an update is ready, the app asks you to restart. If the app isn't in front, a system notification appears instead.
* If you don't restart right away, the update installs the next time you quit the app.
* If you're on the sign-in page, the app restarts into the update without asking.

To check yourself, choose **Check for Updates…** from the **Silkline** menu on Mac, or the **Help** menu on Windows and Linux. The app then shows one of these:

| Message                                                           | What to do                                                                               |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Silkline&#x20;*****version*****&#x20;is ready to install.**     | Click **Restart Now**, or **Later** to install it the next time you quit.                |
| **You're on the latest version of Silkline (*****version*****).** | Nothing. You're up to date.                                                              |
| **Couldn't check for updates.**                                   | Try again later, or reinstall from [download.silkline.ai](https://download.silkline.ai). |

## When an update is required

Silkline may require a newer version of the app before you can sign in. The sign-in page then shows one of these screens:

* **Updating Silkline.** The app is downloading the required version. Keep it open. It restarts on its own when the update is ready.
* **Update Silkline.** The app couldn't update on its own. If **Try again** appears, click it. Otherwise:
  1. Keep Silkline open for a few minutes while it downloads the update.
  2. Quit Silkline completely and reopen it. On Mac, press Cmd+Q. On Windows, close all Silkline windows.
  3. If you still see this screen, reinstall Silkline from [download.silkline.ai](https://download.silkline.ai).

## Troubleshooting

**Your browser didn't open when signing in**

If the app shows **Could not open your browser. Please retry.**, click **Start over** and try again. Check that you have a default web browser set in your operating system's settings.

**The app didn't come back after signing in**

Click **Return to the Silkline app** in the browser tab. Some browsers ask for permission before opening an app. Allow it to open Silkline.

**Sign-in expired**

A sign-in attempt expires after 5 minutes. Click **Start over** in the app to begin again.

**A passkey or security key doesn't work in a sign-in window**

Some single sign-on providers open their sign-in page in a pop-up window inside the app, and passkeys and security keys can't be used there. Choose **Try another way** on your provider's sign-in page and pick another verification method.

**"Only available in the Silkline desktop app"**

Shop for Digi-Key, and every Shop session for FedRAMP and ITAR organizations, runs only in the desktop app. [Download the app](https://docs.silkline.ai/desktop-app.md#download-and-install) and start the session from there.

**"Requires an updated Silkline desktop app"**

Your version of the app is too old for this Shop session. Choose **Check for Updates…** and restart into the new version, or reinstall from [download.silkline.ai](https://download.silkline.ai).

**Something else isn't working**

Choose **File → Sign Out & Reset Session…** to clear the app's saved Silkline data and sign in again. If the problem continues, contact support.
