The OnlyKey App is used for the initial setup and configuration of OnlyKey. Supported on Windows, macOS, Linux, and Chromebook (with Chrome App).
Edit me

OnlyKey App

This is the official app for OnlyKey

OnlyKey can be purchased here: OnlyKey order


OnlyKey App is an app to be used along with an OnlyKey device. The app is used for things like:

  • Initial setup of OnlyKey (PINs)
  • Configuration of accounts (Slots)
  • Loading keys for OpenPGP and secure backup (Keys)
  • Backup and restore of OnlyKey (Backup/Restore)
  • Setting OnlyKey preferences (Preferences)
  • Setting advanced options such as Yubikey and U2F security info (Advanced)

The app is required on all systems where Google Authenticator (TOTP) is used

For information on using the app with OnlyKey see the OnlyKey User’s Guide

Install OnlyKey App

There are two options for installing the OnlyKey app.

Once you have installed the app proceed to OnlyKey Setup

Install OnlyKey Desktop App

Step 1. Download installer




Step 2. Install and launch the app.

Install OnlyKey Chrome App

Step 1. Open the Chrome (or Chromium) Web Browser. If you do not have the chrome web browser installed you can install this by following the instructions here:
Step 2. Click here to browse to the OnlyKey Configuration Web app on the Chrome Web Store and select ‘Add to Chrome’
Step 3. When prompted select ‘‘Add App’’
Step 4. To launch the OnlyKey Configuration App select the top right menu icon -> Bookmarks -> Show Bookmarks Bar to enable the bookmarks bar to become visible. Then select the Apps icon (Or alternatively browse to ‘‘chrome://apps/’’) and then select the ‘‘OK’’ icon to launch the OnlyKey App.


Check out the OnlyKey Support Forum

Check out the OnlyKey Documentation

GNU/Linux users:

Your system may by default only allow read access to USB devices including the OnlyKey. You’ll need to insert a udev rule in order to allow read/write access if the app hangs and you see “Working… please wait”. Here are instructions for inserting a udev rule.

Developer Notes

This repository contains shared code that can be used to build multiple types of apps.

To run this code as a Chrome app:

$ npm run chrome

To run as NWJS app:

$ npm start

To create releases:

$ npm run release

This will create an installer in the releases/ subfolder. The installer is created for the current OS; this means you will need to run the release command on Windows, Linux, and Mac OS to generate all the installers.

On Windows, you need to install [NSIS][nsis] first, and ensure that it’s present in your shell’s %PATH%. That is, add C:/Program Files (x86)/NSIS or similar to your %PATH% in the operating system settings. On Mac OS, you need to install an optional NPM dependecy: npm install appdmg.

To run tests:

$ npm test

Running tests requires the SDK version of NWJS, which comes with a chromedriver that handles automated Selenium tests. To install that version, run npm install nw --nwjs_build_type=sdk. Note that to create releases, you should install the non-sdk variant again; otherwise the installer will be unnecessarily large.

Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country’s laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following cryptographic software is included in this distribution:

“OpenPGP.js - OpenPGP JavaScript Implementation.” -

For more information on export restrictions see:


OnlyKey App on Github