1-Basics
Troubleshoot

Getting Started

Many of our users are coming back after not using their KeepKey devices for a long time. This guide is for users who, for any reason, are not able to connect or access their KeepKey Device.

Most of our users have used their KeepKey devices with either shapeshift.com (opens in a new tab) or, for those who are even older users, the KeepKey Browser Extension.

If this is the case, you MUST update the firmware on your device. To do this, you must use an Updater App.

Message From app.shapeshift.com (opens in a new tab)

Updating Firmware

It is NOT possible to update firmware from app.shapeshift.com. And, as of writing this post, there are only 2 graphical applications that support firmware updating:

The KeepKey updater app was written for KeepKey while it was owned by ShapeShift.

(For Directions on updating your KeepKey with KeepKey desktop go here (opens in a new tab))

TroubleShooting Connections

Terms:

  • WebUSB: the web protocol in which your host machine is communicating to your KeepKey Device.
  • HID: the native USB protocol in which your host machine is communicating to your KeepKey Device.
  • Browser: A web Browser for example Chrome/Brave browser.
  • Electron: A native application framework that runs outside of a web-browser on your host machine.

ShapeShift.com

If you are attempting to connect to app.shapeshift.com from your web browser, the following conditions must be met:

  1. Your KeepKey must be on firmware greater than 6.1.0.
  2. You must be using a web browser with WebUSB support. This is limited to Brave/Chrome and excludes Firefox and Safari.
  3. Your KeepKey cannot be connected to any other web browser's tab via USB. For instance, only the first tab opened with app.shapeshift.com will be able to connect to the device. (It is recommended to close all tabs)
  4. You must not be running KeepKey Desktop OR the KeepKey updater app. It is possible these services are running in the background. Be sure to check your menu trays and perhaps check running tasks to stop them.
  5. Your USB cable must be solid and without damage. It is not uncommon for USB cables to fail. Just because a USB cable can transmit power and Power on a KeepKey does NOT guarantee that the data connection is solid and without issues.
  6. Your Host machine must have valid USB drivers. This is generally only an issue for Linux machines. Linux users may need to adjust their UDEV permissions. Documented here (opens in a new tab)
  7. Linux users may need to chmod keepkey desktop to use it: chmod +x KeepKey-Desktop-2.0.16.AppImage

Electrum Users:

Add python lib: python3 -m pip install keepkey

(Note: If you are users of beta.shapeshift.com and managed your Ripple or DASH from a KeepKey. you can use the following guides to manage these assets.)

Any more requests for coin support bring to our discord. The Full Story

(macOS Sonoma users! you must configure your system to default-allowing all devices to connect)

Understanding All the KeepKey Clients

  • (Deprecated) KeepKey browser extension: This browser extension pre-dates shapeshift and is no longer maintained or hosted. If you see any links to this software it is extremely likely to be a scam.
  • (Deprecated) beta.shapeshift.com: This is the legacy Site many KeepKey users used in the past to manage their crypto.