Installation
Installieren Sie den QubKey-Desktop unter macOS, Windows und Linux – erforderlich für Erweiterung und Synchronisierung.
QubKey ist eine native Desktop-Anwendung, die den Kern des Ökosystems bildet. Laden Sie das Installationsprogramm für Ihr Betriebssystem herunter und führen Sie die folgenden Schritte aus.
Das QubKey-Ökosystem umfasst die Desktop-App (erforderlich – Tresor, Kryptografie, Verwaltung) und die Browser-Erweiterung (optional – automatisches Ausfüllen über Native Messaging). Optionale Synchronisierung über Ihre eigenen Geräte hinweg kann das Local-First-Modell ergänzen (Cloud-Ordner, manuelle Kopie des.rkveyDatei). Zuerst muss die Desktop-App installiert werden – die Erweiterung hängt davon ab.
Installationsreihenfolge
QubKey-Desktop-App
Installieren Sie zuerst die native App: Sie verwaltet die.rkveyTresor, gesamte Kryptografie (Argon2id, AEAD) und Geheimverwaltung. Ohne sie funktioniert die Erweiterung nicht.
Browser-Erweiterung (optional)
Sobald die Desktop-App installiert und ein Tresor erstellt ist, laden Sie die Chrome- oder Firefox-Erweiterung von der Seite mit Browsererweiterungen herunter (macOS- oder Windows-Paket passend zu Ihrem Betriebssystem), konfigurieren Sie Native Messaging und verbinden Sie dann die Erweiterung.
Optionale Synchronisierung (optional)
Eingebaute Synchronisierung mehrerer Geräte (QubKey-Cloud – Selbsthosting in Kürze als Download verfügbar, in den Einstellungen aktiviert) oder manuelles Kopieren/Synchronisieren der verschlüsselten Daten.rkveyDatei (Cloud-Ordner, USB-Laufwerk).
Systemanforderungen
Operating system
macOS (Apple Silicon) und Windows 10/11 (NSIS/MSI) zum Download verfügbar. Linux in aktiver Entwicklung – siehe Versionshinweise und die Download-Seite der Website.
RAM
Mindestens 4 GB – 8 GB empfohlen. Argon2id verbraucht 64 MB pro Entsperrung; Nicht genügend RAM kann das Öffnen des Tresors verlangsamen.
Disk space
200 MB für die Anwendung
WebView
WebView2 (Windows) oder WebKit – gebündelt auf macOS/Linux über Tauri
Herunterladen
macOS
Apple Silicon (arm64).dmg– außerhalb des Mac App Store. Überprüfen Sie den SHA-256-Hash auf der Download-Seite.
Windows
NSIS/MSI-Installationsprogramme für Windows 10/11 (x64 oder x86) – verfügbare Pakete finden Sie auf der entsprechenden Seite.
Linux
In aktiver Entwicklung – noch kein Linux-Download veröffentlicht.
Plattforminstallation
Laden Sie Apple Silicon (arm64) herunter.dmgvon der macOS-Seite
Überprüfen Sie den veröffentlichten SHA-256-Fingerabdruck und öffnen Sie ihn.dmgund ziehen Sie QubKey dorthin/Applications
Beim ersten Start: Rechtsklick → Öffnen, wenn Gatekeeper eine Warnung anzeigt (App außerhalb des Mac App Store)
Gewähren Sie Zugriff auf die Festplatte und den Ordner „Dokumente“, wenn macOS Sie dazu auffordert
Überprüfen Sie die Windows-Seite auf verfügbare NSIS/MSI-Installationsprogramme (x64 oder x86).
Doppelklicken Sie auf das Installationsprogramm und folgen Sie dem Assistenten (wählen Sie den Installationsordner).
Akzeptieren Sie die WebView2-Installation, wenn Sie dazu berechtigt sind (erforderlich für die Tauri-Benutzeroberfläche).
Starten Sie QubKey über das Startmenü – erlauben Sie den Dateizugriff, wenn Windows Sie dazu auffordert
Linux
Die Linux-Version befindet sich in der aktiven Entwicklung. Kein AppImage,.deb, oder.rpmDas Paket wird noch auf der Website angeboten – folgen Sie der Download-Seite für Ankündigungen.
Integritätsüberprüfung
Binäre Integrität
Überprüfen Sie vor der Installation immer die Signatur oder den SHA256-Hash – so stellen Sie sicher, dass die Binärdatei zwischen dem Build und Ihrer Maschine (Lieferkette) nicht manipuliert wurde.
shasum -a 256 QubKey_2.0.0_aarch64.dmgVergleichen Sie mit dem Hash auf der Download-Seite oder in den Versionshinweisen (pro-build-Tabelle).
Nach der Installation
First vault
Erstellen Sie Ihr.rkveyTresor und legen Sie das Master-Passwort fest
Browser-Erweiterung
Installieren Sie die Erweiterung für das automatische Ausfüllen
Sync
Exportieren oder synchronisieren Sie Ihre.rkveyDatei (optional)
Fehlerbehebung
Missing WebView2 (Windows)
Tauri benötigt WebView2, um die Benutzeroberfläche anzuzeigen. Laden Sie es von microsoft.com/edge/webview2 herunter, wenn das Installationsprogramm es nicht angeboten hat.
Gatekeeper blocks (macOS)
Für nicht notariell beglaubigte Builds: Rechtsklick → Öffnen. Alternativ:xattr -cr /Applications/QubKey.appum die Quarantäne aufzuheben.
Missing dependencies (Linux)
Tauri erfordert webkit2gtk. Debian/Ubuntu:sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1