Installation
Installation desktop QubKey sur macOS, Windows et Linux — prérequis pour extension et sync.
QubKey est une application desktop native qui constitue le cœur de l'écosystème. Téléchargez l'installateur correspondant à votre système d'exploitation et suivez les étapes ci-dessous.
L'écosystème QubKey comprend l'application desktop (obligatoire — coffre, cryptographie, gestion) et l'extension navigateur (optionnelle — auto-remplissage via Native Messaging). Une synchronisation optionnelle entre vos propres appareils peut compléter le modèle local-first (dossier cloud, copie manuelle du fichier .rkvey). L'application desktop doit être installée en premier — l'extension en dépend.
Ordre d'installation
Application desktop QubKey
Installez l'application native en premier : elle gère le coffre .rkvey, toute la cryptographie (Argon2id, AEAD) et la gestion de vos secrets. Sans elle, l'extension ne fonctionne pas.
Extension navigateur (optionnel)
Une fois l'app desktop installée et un coffre créé, téléchargez l'extension Chrome ou Firefox depuis la page extensions navigateur (paquets macOS ou Windows selon votre OS), configurez Native Messaging, puis connectez l'extension.
Synchronisation optionnelle (optionnel)
Sync multi-appareils intégrée (cloud QubKey — auto-hébergement bientôt disponible en téléchargement, activée dans Paramètres) ou copie/synchronisation manuelle du fichier .rkvey chiffré (dossier cloud, clé USB).
Prérequis système
Système d'exploitation
macOS (Apple Silicon) et Windows 10/11 (NSIS/MSI) disponibles au téléchargement. Linux en développement actif — consultez les notes de version et la page Téléchargement du site.
RAM
4 Go minimum — 8 Go recommandé. Argon2id utilise 64 Mo par déverrouillage ; une RAM insuffisante peut ralentir l'ouverture du coffre.
Espace disque
200 MB pour l'application
WebView
WebView2 (Windows) ou WebKit — intégré sur macOS/Linux via Tauri
Téléchargement
macOS
.dmg Apple Silicon (arm64) — hors Mac App Store. Vérifiez le hash SHA-256 sur la page de téléchargement.
Windows
Installateurs NSIS/MSI Windows 10/11 (x64 ou x86) — voir la page dédiée pour les paquets disponibles.
Linux
En développement actif — aucun téléchargement Linux publié pour le moment.
Installation par plateforme
Téléchargez le fichier .dmg Apple Silicon (arm64) depuis la page macOS
Vérifiez l'empreinte SHA-256 publiée, ouvrez le .dmg et glissez QubKey dans /Applications
Au premier lancement : clic droit → Ouvrir si Gatekeeper affiche un avertissement (app hors Mac App Store)
Autorisez l'accès disque et au dossier Documents si macOS le demande
Consultez la page Windows pour les installateurs NSIS/MSI (x64 ou x86) disponibles
Double-cliquez sur l'installateur et suivez l'assistant (choisissez le dossier d'installation)
Acceptez l'installation de WebView2 si demandé (requis pour l'interface Tauri)
Lancez QubKey depuis le menu Démarrer — autorisez l'accès aux fichiers si Windows le demande
Linux
La version Linux est en développement actif. Aucun paquet AppImage, .deb ou .rpm n'est proposé sur le site pour le moment — suivez la page Téléchargement pour les annonces.
Vérification de l'intégrité
Intégrité du binaire
Vérifiez toujours la signature ou le hash SHA256 avant d'installer — cela garantit que le binaire n'a pas été altéré entre le build et votre machine (supply chain).
shasum -a 256 QubKey_2.0.0_aarch64.dmgComparez avec le hash publié sur la page de téléchargement ou dans les Notes de version (tableau par build).
Après installation
Premier coffre
Créez votre coffre .rkvey et définissez le mot de passe maître
Extension navigateur
Installez l'extension pour l'auto-remplissage
Synchronisation
Exportez ou synchronisez votre fichier .rkvey (optionnel)
Dépannage
WebView2 manquant (Windows)
Tauri nécessite WebView2 pour afficher l'interface. Téléchargez-le depuis microsoft.com/edge/webview2 si l'installateur ne l'a pas proposé.
Gatekeeper bloque (macOS)
Pour les builds non notarisés : clic droit → Ouvrir. En alternative : xattr -cr /Applications/QubKey.app pour retirer la quarantaine.
Dépendances manquantes (Linux)
Tauri requiert webkit2gtk. Debian/Ubuntu : sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1