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


To use the OnlyKey Desktop App:

  • Obtain an installer from
  • Install and launch the app.

To use the OnlyKey Chrome App: (Chromebook Users)

  • Go to, click the ADD TO CHROME button.
  • Once the app installs ensure that your Chrome Bookmarks Bar is visible by going to Bookmarks -> Show Bookmarks bar.
  • Select “Apps” icon in the bookmarks bar and select OnlyKey Configuration.


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