# Firmware Loading

**URL:** https://onlykey.discourse.group/c/firmware-loading/6.md

[Latest](https://onlykey.discourse.group/latest.md) · [Categories](https://onlykey.discourse.group/categories.md)

---

## [About the Firmware Loading category](https://onlykey.discourse.group/t/about-the-firmware-loading-category/12)

<div class="topic-metadata">

**Author:** [@t11](https://onlykey.discourse.group/u/t11)\
**Replies:** 0

</div>

Discussion and support for loading OnlyKey firmware, see Loading OnlyKey Firmware in the user’s guide here.

---

## [How to compile / build the firmware?](https://onlykey.discourse.group/t/how-to-compile-build-the-firmware/1463)

<div class="topic-metadata">

**Author:** [@Robert](https://onlykey.discourse.group/u/Robert)\
**Replies:** 6\
**Last updated:** [December 28, 2025, 4:38pm UTC](https://onlykey.discourse.group/t/how-to-compile-build-the-firmware/1463 "2025-12-28T16:38:43Z")

</div>

Hi, I would like to compile the firmware myself, but cannot find resource how to do so, or if they are very old and seem not to work anymore. Is it still supported that users can work themselves on the firmware?

---

## [How to know when new firmware is available?](https://onlykey.discourse.group/t/how-to-know-when-new-firmware-is-available/1495)

<div class="topic-metadata">

**Author:** [@tony](https://onlykey.discourse.group/u/tony)\
**Replies:** 1\
**Last updated:** [August 14, 2025, 5:16am UTC](https://onlykey.discourse.group/t/how-to-know-when-new-firmware-is-available/1495 "2025-08-14T05:16:07Z")

</div>

Apologies if this is already answered but I did not see it. I recently got my only-key, and I loaded the latest firmware, but Is there a way to know when new firmware becomes available? I subscribe to the newsletter at…

---

## [Onlykey Color Unresponsive, except if I short the two pins](https://onlykey.discourse.group/t/onlykey-color-unresponsive-except-if-i-short-the-two-pins/1453)

<div class="topic-metadata">

**Author:** [@grangerx](https://onlykey.discourse.group/u/grangerx)\
**Replies:** 0\
**Last updated:** [May 1, 2025, 8:27pm UTC](https://onlykey.discourse.group/t/onlykey-color-unresponsive-except-if-i-short-the-two-pins/1453 "2025-05-01T20:27:24Z")

</div>

Hi all, I have several OnlyKeys. One of the ones I don’t use very often didn’t respond at all when I plugged it into USB the other day. As far as I can tell, it doesn’t cause Windows to think there’s a device plugged …

---

## [How to build firmware?](https://onlykey.discourse.group/t/how-to-build-firmware/1317)

<div class="topic-metadata">

**Author:** [@skratch8four](https://onlykey.discourse.group/u/skratch8four)\
**Replies:** 3\
**Last updated:** [November 27, 2024, 4:59pm UTC](https://onlykey.discourse.group/t/how-to-build-firmware/1317 "2024-11-27T16:59:48Z")

</div>

Hi how do I build the firmware? Can the CryptoTrust provided firmware file be disassembled?

---

## [After failed FW update key not recognised and has solid white LED](https://onlykey.discourse.group/t/after-failed-fw-update-key-not-recognised-and-has-solid-white-led/1308)

<div class="topic-metadata">

**Author:** [@Ton](https://onlykey.discourse.group/u/Ton)\
**Replies:** 2\
**Last updated:** [July 12, 2024, 9:44am UTC](https://onlykey.discourse.group/t/after-failed-fw-update-key-not-recognised-and-has-solid-white-led/1308 "2024-07-12T09:44:57Z")

</div>

When I updated the firmware on my OnlyKey, bought in 2019, it stopped during FW upgrade and the app showed, during flash, “Please connect your Onlykey”. Nothing happened after this. After half an hour I re-plugged the ke…

---

## [OnlyKey Initial Setup on Tails with Firmware Update](https://onlykey.discourse.group/t/onlykey-initial-setup-on-tails-with-firmware-update/982)

<div class="topic-metadata">

**Author:** [@OnlyKeen](https://onlykey.discourse.group/u/OnlyKeen)\
**Replies:** 8\
**Last updated:** [April 25, 2023, 5:17pm UTC](https://onlykey.discourse.group/t/onlykey-initial-setup-on-tails-with-firmware-update/982 "2023-04-25T17:17:20Z")

</div>

Hello. I have encountered unexpected behaviour while going through the initial setup process of an OnlyKey on Tails with network access disabled. I have loaded up the app and right at the beginning you are given the opt…

---

## [Firmware 2.1.2 "file block too large"](https://onlykey.discourse.group/t/firmware-2-1-2-file-block-too-large/760)

<div class="topic-metadata">

**Author:** [@Ian](https://onlykey.discourse.group/u/Ian)\
**Replies:** 10\
**Last updated:** [January 6, 2023, 5:12am UTC](https://onlykey.discourse.group/t/firmware-2-1-2-file-block-too-large/760 "2023-01-06T05:12:02Z")

</div>

When I try to upgrade from 2.1.1-prodc with downloaded firmware Signed\_OnlyKey\_2\_1\_2\_STD.txt I get “Error firmware file block too large”. I checked it against the hash and it’s fine. I see there was an old issue Firmware…

---

## [Onlykey Duo no longer consistantly typing over RDP after firmware update](https://onlykey.discourse.group/t/onlykey-duo-no-longer-consistantly-typing-over-rdp-after-firmware-update/838)

<div class="topic-metadata">

**Author:** [@jer](https://onlykey.discourse.group/u/jer)\
**Replies:** 4\
**Last updated:** [November 8, 2022, 8:02pm UTC](https://onlykey.discourse.group/t/onlykey-duo-no-longer-consistantly-typing-over-rdp-after-firmware-update/838 "2022-11-08T20:02:04Z")

</div>

I just installed the latest firmware for Duo (3.0.1) as I was very much wanting to use it with my Samsung S21. However, since this, now there is an issue typing passwords over RDP and it does not turn out consistent 2 ti…

---

## [Is v3.0.2-prod ready?](https://onlykey.discourse.group/t/is-v3-0-2-prod-ready/889)

<div class="topic-metadata">

**Author:** [@Stammer9222](https://onlykey.discourse.group/u/Stammer9222)\
**Replies:** 1\
**Last updated:** [November 8, 2022, 4:58pm UTC](https://onlykey.discourse.group/t/is-v3-0-2-prod-ready/889 "2022-11-08T16:58:50Z")

</div>

I noticed that v3.0.2-prod is pre-release when will v3.0.x be officially released?

---

## [Firmware upgrade problems: onlykey un-usable (help!)](https://onlykey.discourse.group/t/firmware-upgrade-problems-onlykey-un-usable-help/753)

<div class="topic-metadata">

**Author:** [@DrOteonu](https://onlykey.discourse.group/u/DrOteonu)\
**Replies:** 0\
**Last updated:** [May 23, 2022, 7:20pm UTC](https://onlykey.discourse.group/t/firmware-upgrade-problems-onlykey-un-usable-help/753 "2022-05-23T19:20:00Z")

</div>

Onlykey-app version 5.3.6. Onlykey stick: bought around november 2020 This is an SOS message, as I am currently stuck with a non-functioning onlykey that has worked perfectly for 2 years. The problem and questions: T…

---

## [Unable to load OnlyKey app bootloader on Qubes OS](https://onlykey.discourse.group/t/unable-to-load-onlykey-app-bootloader-on-qubes-os/87)

<div class="topic-metadata">

**Author:** [@RustyFish](https://onlykey.discourse.group/u/RustyFish)\
**Replies:** 11\
**Last updated:** [April 1, 2022, 8:19pm UTC](https://onlykey.discourse.group/t/unable-to-load-onlykey-app-bootloader-on-qubes-os/87 "2022-04-01T20:19:09Z")

</div>

Hello, I am having an issue loading new firmware and wiping the firmware on my onlykey color. I am doing this on a linux computer. First of all I wiped my onlykey by purposely typing in the wrong pin 10 times. The light…

---

## [OnlyKey Duo firmware loading](https://onlykey.discourse.group/t/onlykey-duo-firmware-loading/660)

<div class="topic-metadata">

**Author:** [@Stevie](https://onlykey.discourse.group/u/Stevie)\
**Replies:** 7\
**Last updated:** [March 17, 2022, 12:44pm UTC](https://onlykey.discourse.group/t/onlykey-duo-firmware-loading/660 "2022-03-17T12:44:44Z")

</div>

Hi! Just got my OnlyKey Duo. Looks really nice, delivery was fast. So thanks for that. However, I cannot get it to work. The OnlyKey App was not reacting to presses of “next” during setup. I use the newest version 5.3.…

---

## [2.1.2 firmware update-HMAC for KeepassXC](https://onlykey.discourse.group/t/2-1-2-firmware-update-hmac-for-keepassxc/614)

<div class="topic-metadata">

**Author:** [@tfluthy](https://onlykey.discourse.group/u/tfluthy)\
**Replies:** 10\
**Last updated:** [February 23, 2022, 2:07pm UTC](https://onlykey.discourse.group/t/2-1-2-firmware-update-hmac-for-keepassxc/614 "2022-02-23T14:07:45Z")

</div>

I had the same issues as I had with previous firmware versions. You must remove the HMAC challenge from KeepassXC as it will not be preserved from 2.1.1 to 2.1.2, nor will it be preserved by restoring a backup. The onl…

---

## [Identify firmware updating or restoring to factory mode](https://onlykey.discourse.group/t/identify-firmware-updating-or-restoring-to-factory-mode/499)

<div class="topic-metadata">

**Author:** [@gzm55](https://onlykey.discourse.group/u/gzm55)\
**Replies:** 3\
**Last updated:** [September 6, 2021, 1:20pm UTC](https://onlykey.discourse.group/t/identify-firmware-updating-or-restoring-to-factory-mode/499 "2021-09-06T13:20:30Z")

</div>

Is there a hardware counter/hash/timestamp of last successfully firmware updating or restoring to factory mode? This identify information should not be changed directly by any normal firmware functions, and always be dif…

---

## [How to load firmware when Onlykey app does not detect Onlykey](https://onlykey.discourse.group/t/how-to-load-firmware-when-onlykey-app-does-not-detect-onlykey/479)

<div class="topic-metadata">

**Author:** [@grangerx](https://onlykey.discourse.group/u/grangerx)\
**Replies:** 2\
**Last updated:** [August 24, 2021, 2:29am UTC](https://onlykey.discourse.group/t/how-to-load-firmware-when-onlykey-app-does-not-detect-onlykey/479 "2021-08-24T02:29:06Z")

</div>

Hi all, I have an Onlykey running one of the newer/signed firmwares. I mostly use it on Windows 10 with the OnlyKey app. It was behaving well, but I needed it for a different project, so I used the “wrong password 10 …

---

## [How to update firmware](https://onlykey.discourse.group/t/how-to-update-firmware/463)

<div class="topic-metadata">

**Author:** [@Michele](https://onlykey.discourse.group/u/Michele)\
**Replies:** 2\
**Last updated:** [August 16, 2021, 7:19pm UTC](https://onlykey.discourse.group/t/how-to-update-firmware/463 "2021-08-16T19:19:13Z")

</div>

Hi I received my Only key about 5 months ago. Occasionally get a message in the app to update the firmware. As I follow the process ef holding the #6 key for 5 seconds everything seems to work as described but then i…

---

## [Problem loading version 5.3.3](https://onlykey.discourse.group/t/problem-loading-version-5-3-3/450)

<div class="topic-metadata">

**Author:** [@Seth](https://onlykey.discourse.group/u/Seth)\
**Replies:** 1\
**Last updated:** [July 19, 2021, 2:56pm UTC](https://onlykey.discourse.group/t/problem-loading-version-5-3-3/450 "2021-07-19T14:56:44Z")

</div>

While attempting to update version 5.3.0 to 5.3.3, I encountered a problem that is now preventing OnlyKey from opening. When I attempt to open Only Key I get a Window that says NW.JS (see image).

---

## [Old OnlyKey from 2017 firmware loading](https://onlykey.discourse.group/t/old-onlykey-from-2017-firmware-loading/375)

<div class="topic-metadata">

**Author:** [@Jack](https://onlykey.discourse.group/u/Jack)\
**Replies:** 4\
**Last updated:** [April 26, 2021, 6:22pm UTC](https://onlykey.discourse.group/t/old-onlykey-from-2017-firmware-loading/375 "2021-04-26T18:22:51Z")

</div>

I just upgraded an original (unused) OnlyKey to the Beta 7 standard firmware using Teensy. It worked, but when I opened the Desktop app to do the initial configuration, it asked me to upgrade the firmware again (that wa…

---

## [Cannot Load OnlyKey App](https://onlykey.discourse.group/t/cannot-load-onlykey-app/259)

<div class="topic-metadata">

**Author:** [@QuietShadow](https://onlykey.discourse.group/u/QuietShadow)\
**Replies:** 4\
**Last updated:** [March 15, 2021, 2:43pm UTC](https://onlykey.discourse.group/t/cannot-load-onlykey-app/259 "2021-03-15T14:43:01Z")

</div>

I hope this is the right place. I just got my key and I am anxious to set it up. I downloaded and installed the app, but when I went to open it, it just flashes for a second on the screen and then disappears. I was able…

---

## [Firmware questions](https://onlykey.discourse.group/t/firmware-questions/241)

<div class="topic-metadata">

**Author:** [@paulnot](https://onlykey.discourse.group/u/paulnot)\
**Replies:** 3\
**Last updated:** [February 22, 2021, 4:03pm UTC](https://onlykey.discourse.group/t/firmware-questions/241 "2021-02-22T16:03:37Z")

</div>

Hi. I’m actually quite techy, I ran a tech company for 20 years. But I find the only key documentation really poor and can’t actually get it to do anything. My first question is about the firmware. I found a page on the …

---

## [Assets missing from Release page](https://onlykey.discourse.group/t/assets-missing-from-release-page/61)

<div class="topic-metadata">

**Author:** [@timetoseek](https://onlykey.discourse.group/u/timetoseek)\
**Replies:** 1\
**Last updated:** [October 26, 2020, 2:37am UTC](https://onlykey.discourse.group/t/assets-missing-from-release-page/61 "2020-10-26T02:37:30Z")

</div>

As of today (10/23/20) It seems that 3 assets are missing from the Release page. I only see the source, but not the compiled version. Please add…

---

## [KeepassXC HMAC Challenge Issue After Firmware Upgrade](https://onlykey.discourse.group/t/keepassxc-hmac-challenge-issue-after-firmware-upgrade/65)

<div class="topic-metadata">

**Author:** [@tfluthy](https://onlykey.discourse.group/u/tfluthy)\
**Replies:** 18\
**Last updated:** [November 4, 2020, 2:41am UTC](https://onlykey.discourse.group/t/keepassxc-hmac-challenge-issue-after-firmware-upgrade/65 "2020-11-04T02:41:21Z")

</div>

Loaded the newest firmware and upgraded the APP. Everything seems to be working except my KeepassXC Challenge response. I followed the upgrade steps as written, but the HMAC Challenge is not working after doing the res…

---

## [MacBook not loading OnlyKey](https://onlykey.discourse.group/t/macbook-not-loading-onlykey/57)

<div class="topic-metadata">

**Author:** [@brightwolf](https://onlykey.discourse.group/u/brightwolf)\
**Replies:** 3\
**Last updated:** [October 20, 2020, 4:38pm UTC](https://onlykey.discourse.group/t/macbook-not-loading-onlykey/57 "2020-10-20T16:38:40Z")

</div>

OnlyKey works fine on my early 2009 iMac. However, on my mid 2015 MacBook it won’t load. When I first plugged it in, the keyboard assistant was showing. I clicked the red close button on the window. The OnlyKey flashed s…

---

## [Firmware wiped after 10 wrong PINs](https://onlykey.discourse.group/t/firmware-wiped-after-10-wrong-pins/30)

<div class="topic-metadata">

**Author:** [@sit.cwi](https://onlykey.discourse.group/u/sit.cwi)\
**Replies:** 1\
**Last updated:** [September 30, 2020, 6:24pm UTC](https://onlykey.discourse.group/t/firmware-wiped-after-10-wrong-pins/30 "2020-09-30T18:24:07Z")

</div>

Now I ended up having a token that is showing ‘unlocked BOOTLOADERv1’ instead of real firmware version … How can I fix my token ?
