Installatie
Installeer QubKey desktop op macOS, Windows en Linux — vereist voor uitbreiding en synchronisatie.
QubKey is een native desktop-applicatie die de kern van het ecosysteem vormt. Download het installatieprogramma voor uw besturingssysteem en volg de onderstaande stappen.
Het QubKey-ecosysteem omvat de desktop-app (vereist – kluis, cryptografie, beheer) en de browserextensie (optioneel – automatisch aanvullen via Native Messaging). Optionele synchronisatie op uw eigen apparaten kan een aanvulling zijn op het local-first-model (cloudmap, handmatige kopie van het .rkvey-bestand). De desktop-app moet eerst worden geïnstalleerd; de extensie is ervan afhankelijk.
Installatievolgorde
QubKey desktop-app
Installeer eerst de native app: deze beheert de .rkvey-kluis, alle cryptografie (Argon2id, AEAD) en geheimbeheer. Zonder dit werkt de extensie niet.
Browserextensie (optioneel)
De desktop-app is grotendeels onmogelijk en er is een kluis gemaakt, download de Chrome- of Firefox-extensie van de pagina met browserextensies (macOS- of Windows-pakket dat onmogelijk is met uw besturingssysteem), configureer u Native Messaging en sluit u vervolgens de extensie aan.
Optionele synchronisatie (optioneel)
Ingebouwde synchronisatie van meerdere apparaten (QubKey-cloud of zelf-gehoste server, gekozen in Instellingen) of handmatig kopiëren/synchroniseren van het .rkvey-bestand (cloudmap, USB-station).
Systeemvereisten
Operating system
macOS (Apple Silicon) en Windows 10/11 (NSIS/MSI) beschikbaar om te downloaden. Linux in actieve ontwikkeling — zie release-opmerkingen en de downloadpagina van de site.
RAM
4 GB minimaal — 8 GB aanbevolen. Argon2id gebruikt 64 MB per ontgrendeling; onvoldoende RAM kan het openen van de kluis vertragen.
Disk space
200 MB voor de applicatie
WebView
WebView2 (Windows) of WebKit — gebundeld op macOS/Linux via Tauri
Downloaden
macOS
Apple Silicon (arm64) .dmg — buiten de Mac App Store. Controleer de SHA-256-hash op de downloadpagina.
Ramen
NSIS/MSI-installatieprogramma's voor Windows 10/11 (x64 of x86) — zie de speciale pagina voor beschikbare pakketten.
Linux
In actieve ontwikkeling - nog geen Linux-download gepubliceerd.
Platforminstallatie
Download de Apple Silicon (arm64) .dmg van de macOS-pagina
Controleer de gepubliceerde SHA-256-vingerafdruk, open de .dmg en sleep QubKey naar /Applications
Bij de eerste keer geldig: klik met de tijdelijke → Openen als Gatekeeper een waarschuwing toont (app buiten de Mac App Store)
Verleen schijf- en documentenmaptoegang als macOS daarom vraagt
Controleer de Windows-pagina voor beschikbare NSIS/MSI-installatieprogramma's (x64 of x86)
Dubbelklik op het installatieprogramma en volg de wizard (kies installatiemap)
Accepteer de installatie van WebView2 als daarom wordt gevraagd (vereist voor Tauri UI)
Start QubKey vanuit het Start-menu - sta bestandstoegang toe als Windows daarom vraagt
Linux
De Linux-versie is in actieve ontwikkeling. Er wordt geen AppImage-, .deb- of .rpm-pakket aangeboden op de site. Volg de downloadpagina voor aankondigingen.
Integriteitsverificatie
Binaire integriteit
Controleer altijd de handtekening van SHA256-hash voordat u installeert. Dit zorgt ervoor dat er niet met het binaire bestand geknoeid is tussen de build en uw machine (toeleveringsketen).
shasum -a 256 QubKey_2.0.0_aarch64.dmgVergelijkpagina met de hash op de download of in Releaseopmerkingen (tabel per build).
Post-installatie
First vault
Maak uw .rkvey-kluis aan en stel het hoofdwachtwoord in
Browser-extensie
Installeer de extensie voor automatisch aanvullen
Sync
Exporteer of synchroniseer uw .rkvey-bestand (optioneel)
Problemen oplossen
Missing WebView2 (Windows)
Tauri heeft WebView2 nodig om de gebruikersinterface weer te geven. Download het van microsoft.com/edge/webview2 als het installatieprogramma dit niet aanbiedt.
Gatekeeper blocks (macOS)
Voor niet-notariële builds: klik met de rechtermuisknop → Openen. Alternatief: xattr -cr /Applications/QubKey.app om de quarantaine te verwijderen.
Missing dependencies (Linux)
Tauri vereist webkit2gtk. Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1