Follow this guide to upgrade firmware from Beta6 to Beta7
Edit me

Why Upgrade?

This release has a lot of improvements, most notably after upgrading your OnlyKey you can load future updates directly in the app without the need to backup and restore. Here is the short list of improvements in this release:

  • Better touch sense on OnlyKey buttons using automatic touch sense calibration.
  • Backup Passphrase support - Backup’s may be securely encrypted with a passphrase.
  • Two profile support - By setting two PINs you can have two profiles to store up to 24 accounts.
  • Automatic firmware and app update notifications - The OnlyKey app can now let you know when there are updates available.
  • Seamless firmware upgrades - Signed firmware can now be loaded directly through the app without wiping account data (thanks to our new blockchain bootloader).
  • Better FIDO U2F support

Steps to Upgrade

Step 1. Backup OnlyKey - Create a backup of your OnlyKey by going to the Backup/Restore tab in the OnlyKey app. Ensure you have a copy of your backup key (User Guide Backup Instructions here).
Step 2. Upgrade OnlyKey firmware - Follow instructions here to upgrade firmware on the OnlyKey
Step 3. Upgrade OnlyKey desktop app - Follow instructions here to install the new OnlyKey app.
Step 4. Setup OnlyKey - Follow instructions here to setup OnlyKey and restore from backup
Step 4. Check out the new features here

Steps to Upgrade OnlyKey firmware

Before Getting Started

Step 1. Insert OnlyKey into USB port
Step 2. Download and install Teensy Loader
Step 3. Determine which version of OnlyKey you have and download firmware below
OnlyKey Color (Has a square LED) OnlyKey Original (Has text "LED" visible)
Download OnlyKey Color Standard Edition firmware here Download OnlyKey Original Standard Edition firmware here
Download OnlyKey Color International Travel Edition firmware here Download OnlyKey Original International Travel Edition firmware here
Step 4. You can ensure the integrity of your downloaded firmware by verifying the checksum
File Name SHA 256 Checksums
OnlyKey_Beta7_STD_Color.cpp.hex 9fdbce158d6858a7b8ae63c164e015066b0f0b02b55ebba462b7f147e824c1e3
OnlyKey_Beta7_STD_Original.cpp.hex ab42a2d6e2630ada1050a1b7835b1dd06c08c8db40cc3004efe7e483bb89c1a1
OnlyKey_Beta7_IN_TRVL_Color.cpp.hex c9bda251ac22d9228de035d95bb9d57b0909fb432af7057c2df816b4049ca345
OnlyKey_Beta7_IN_TRVL_Original.cpp.hex fd567d88f073e10cddf72cf028d9073d5f379cb026383928f16bdda49b37c1ba
Step 5. In Teensy Loader select File -> Open HEX File. Then select the firmware you downloaded and click open.
Step 6. Now the firmware should appear at the bottom of the Teensy Loader application.
Step 7. In order to enable the OnlyKey to upload the new firmware a jumper (Paperclip, aluminum foil etc) must make contact between the two small copper color circles shown while the OnlyKey is plugged into the USB port.
Step 8. With the Teensy Loader in the foreground, you should now see the Teensy Loader progress bar and then a reboot complete appear in the Teensy Loader which indicates that the firmware has loaded successfully.

Under The Hood - What actually happens when you load the firmware is that a mass erase is completed first. What this means is that all data is completely wiped, and then the new firmware is loaded.

Install OnlyKey Desktop App

Step 1. Download installer

macOS

Windows

Linux

Step 2. Install and launch the app.

Steps to Setup OnlyKey

Now that the new OnlyKey app and firmware are installed its time to setup OnlyKey.

Step 1. Select [Next] to get started.

Step 2. Enter a PIN code, check the disclaimer box, and select [Next].

Step 3. Re-enter PIN code, and select [Next].
Step 4. Enter a PIN code for second profile, check the disclaimer box, and select [Next].

Step 5. If you wish to set a self-destruct PIN enter a PIN code, check the disclaimer box, and select [Next].

Step 6. Re-enter PIN code, and select [Next].
Step 7. Select [Use PGP Key instead of passphrase]

Step 8. With slot 1 selected, paste OpenPGP RSA key and enter passphrase and then select [Next].

Step 9. If you generated your keys as described in the Generating Keys section select [subkey 1] and then select [Save]. If you generated a custom backup key then load the subkey used for backups to slot 1.

Step 10. Select [Choose File] and select your OnlyKey backup file and then select [Next] to load it onto your OnlyKey. Your device will reboot automatically when the restore is complete.

Your device is now set up!

Check out the new app features below.

New OnlyKey Features

Backup Passphrase

Keys are great but a passphrase is an easier way to securely backup your OnlyKey. If you are already using an OpenPGP key for backup you can switch to a passphrase simply by following the instructions on the [Set Backup Passphrase or Key] page. Your OpenPGP key will remain on the OnlyKey but the passphrase will be used for future backup and restore.

Two Profile Support

You may notice now that when setting your PINs there is a primary profile and a secondary profile. The secondary profile can be either a standard profile or plausible deniability profile. This is a change as the previous OnlyKey release only had the option for the second profile to be a plausible deniability profile. The standard profile is a full featured second profile with 12 available slots and the plausible deniablity profile is a limited feature second profile that looks and acts just like a device with International Travel Edition firmware.

In App Firmware Updates

You may notice now that there is an option in the app to load firmware when setting up a device. There is also a tab named Firmware in the app. This may be used to load the latest firmware onto OnlyKey directly through the app, no backup/restore or wiping is required. Firmware updates are securely signed using a simple blockchain and verified by on the OnlyKey.

Tags: