---
title: Troubleshooting
description: Every troubleshooting page in the docs, with the problems each one covers.
url: https://keyguard.dev/docs/troubleshooting/
platforms:
  - android
  - linux
  - macos
  - windows
premium: false
---

# Troubleshooting

Each page lists symptoms for one area, with the cause and the fix. Feature pages also end with a short “Troubleshooting” section for problems specific to that feature.

- [License keys](https://keyguard.dev/docs/license-keys/)

  - [”No eligible purchase found”](https://keyguard.dev/docs/license-keys/#no-eligible-purchase-found)
  - [”Could not obtain entitlement token”](https://keyguard.dev/docs/license-keys/#could-not-obtain-entitlement-token)
  - [”Invalid or expired key”](https://keyguard.dev/docs/license-keys/#invalid-or-expired-key)
  - [Lost web purchase key](https://keyguard.dev/docs/license-keys/#lost-web-purchase-key)

- [Quick search](https://keyguard.dev/docs/quick-search/)

  - [”Accessibility access required”](https://keyguard.dev/docs/quick-search/#accessibility-access-required)
  - [”Could not focus the destination”](https://keyguard.dev/docs/quick-search/#could-not-focus-the-destination)
  - [”Cannot auto-type this value”](https://keyguard.dev/docs/quick-search/#cannot-auto-type-this-value)
  - [”Release all keys and mouse buttons, then try again”](https://keyguard.dev/docs/quick-search/#release-all-keys-and-mouse-buttons-then-try-again)

- [Troubleshoot autofill and passkeys](https://keyguard.dev/docs/troubleshoot-autofill/)

  - [Chrome doesn’t show Keyguard suggestions](https://keyguard.dev/docs/troubleshoot-autofill/#chrome-doesnt-show-keyguard-suggestions)
  - [Autofill dialogs don’t appear on a Xiaomi device](https://keyguard.dev/docs/troubleshoot-autofill/#autofill-dialogs-dont-appear-on-a-xiaomi-device)
  - [A password field gets no suggestions](https://keyguard.dev/docs/troubleshoot-autofill/#a-password-field-gets-no-suggestions)
  - [The wrong logins are suggested](https://keyguard.dev/docs/troubleshoot-autofill/#the-wrong-logins-are-suggested)
  - [Keyguard isn’t offered when you create a passkey](https://keyguard.dev/docs/troubleshoot-autofill/#keyguard-isnt-offered-when-you-create-a-passkey)
  - [A browser shows “Authorize this app” instead of your passkeys](https://keyguard.dev/docs/troubleshoot-autofill/#a-browser-shows-authorize-this-app-instead-of-your-passkeys)
  - [The device doesn’t support credential providers](https://keyguard.dev/docs/troubleshoot-autofill/#the-device-doesnt-support-credential-providers)
  - [”Install Keyguard from the Microsoft Store or an MSIX package to use passkeys”](https://keyguard.dev/docs/troubleshoot-autofill/#install-keyguard-from-the-microsoft-store-or-an-msix-package-to-use-passkeys)
  - [”Update your operating system to use Keyguard as a passkey provider”](https://keyguard.dev/docs/troubleshoot-autofill/#update-your-operating-system-to-use-keyguard-as-a-passkey-provider)

- [Lock and unlock](https://keyguard.dev/docs/lock-and-unlock/)

  - [You forgot the app password](https://keyguard.dev/docs/lock-and-unlock/#you-forgot-the-app-password)
  - [You forgot the Bitwarden master password](https://keyguard.dev/docs/lock-and-unlock/#you-forgot-the-bitwarden-master-password)
  - [You forgot the KeePass password](https://keyguard.dev/docs/lock-and-unlock/#you-forgot-the-keepass-password)

- [GPG agent](https://keyguard.dev/docs/gpg-agent/)

  - [”Failed to start the GPG agent”](https://keyguard.dev/docs/gpg-agent/#failed-to-start-the-gpg-agent)
  - [gpg reports “No secret key”](https://keyguard.dev/docs/gpg-agent/#gpg-reports-no-secret-key)

- [Environments](https://keyguard.dev/docs/environments/)

  - [”Unavailable. Check that the path is free and its folder is writable”](https://keyguard.dev/docs/environments/#unavailable-check-that-the-path-is-free-and-its-folder-is-writable)
  - [keyguard reports “Keyguard is not running, or its CLI agent is stopped”](https://keyguard.dev/docs/environments/#keyguard-reports-keyguard-is-not-running-or-its-cli-agent-is-stopped)
  - [keyguard reports “Some variables are unset or reference an item that is missing or hidden”](https://keyguard.dev/docs/environments/#keyguard-reports-some-variables-are-unset-or-reference-an-item-that-is-missing-or-hidden)
  - [A tool reads an empty .env file](https://keyguard.dev/docs/environments/#a-tool-reads-an-empty-env-file)

- [Wear OS](https://keyguard.dev/docs/wear-os/)
  - [”No paired Android phone found”](https://keyguard.dev/docs/wear-os/#no-paired-android-phone-found)