Download and install the QubKey browser extension for Chrome or Firefox on macOS or Windows. You must configure Native Messaging with the matching desktop app before use.
Choose your operating system
Pick the package that matches your QubKey desktop app. macOS and Windows builds are slightly different and are not interchangeable.
Release 1.0.0 — select macOS or Windows above, then download the Chrome (.zip) or Firefox (.xpi) package for that platform.
SHA-256 of the Chrome .zip (verify your download before installing)
91e6df76ae5cefd3e925d88bb6f25f1cb761023d9edfd83eed9fe0d306bcdffeSHA-256 of the Firefox .xpi (verify your download before installing)
af7606d8543dbb6142ba9c395e3241908ddbc5c1ffcf56ee673416c0c87837afChrome: The .zip is only an archive. Extract it to a folder with manifest.json at the root, then in chrome://extensions enable Developer mode and use “Load unpacked”. Chrome does not install the zip by double-clicking it.
Firefox: The .xpi is for AMO submission or specific local installs. Standard Firefox Release usually requires a Mozilla-signed build from addons.mozilla.org.
The extension talks to the QubKey desktop app through Native Messaging. Set up the native host (JSON manifest, binary, paths) using the Native Messaging documentation in your desktop project before use.
Install and open the QubKey desktop app for macOS (Apple Silicon) using the Download & installation guide. Keep the vault unlocked while testing the extension.
On macOS, install com.passmanager.native.json under ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/ (and the equivalent folders for Firefox, Edge, and Opera). Set path to the native helper inside QubKey.app.
After loading the extension manually, copy the extension ID shown in the browser into the com.passmanager.native.json host manifest as described in that documentation.
On macOS, Chrome, Brave, and other Chromium browsers follow the same steps. Microsoft Edge on Mac uses edge://extensions with the same unpacked folder.
After publishing on addons.mozilla.org (AMO), users install the add-on in one click like any standard extension, without about:debugging. The .xpi is the package to upload to AMO (or a build artifact) once API access is configured.
On macOS, try about:addons → gear menu → Install Add-on From File and select passmanager-firefox-1.0.0.xpi. This works only on Firefox Nightly/Developer Edition or when signature checks are disabled. On standard Firefox Release, an unsigned .xpi is usually blocked.
For beta testing on macOS: rename passmanager-firefox-1.0.0.xpi to .zip, extract it, then open about:debugging → This Firefox → Load Temporary Add-on and choose manifest.json in the extracted folder. Reload after every Firefox restart.