Installazione
Installa il desktop QubKey su macOS, Windows e Linux: richiesto per l'estensione e la sincronizzazione.
QubKey è un'applicazione desktop nativa che costituisce il nucleo dell'ecosistema. Scarica il programma di installazione per il tuo sistema operativo e segui i passaggi seguenti.
L'ecosistema QubKey include l'app desktop (richiesta: archivio, crittografia, gestione) e l'estensione del browser (facoltativa: compilazione automatica tramite messaggistica nativa). La sincronizzazione opzionale tra i tuoi dispositivi può integrare il modello local-first (cartella cloud, copia manuale del file .rkvey). L'app desktop deve essere installata prima: l'estensione dipende da essa.
Ordine di installazione
Applicazione desktop QubKey
Installa prima l'app nativa: gestisce il vault .rkvey, tutta la crittografia (Argon2id, AEAD) e la gestione dei segreti. Senza di esso, l'estensione non funziona.
Estensione del browser (opzionale)
Una volta installata l'app desktop e creato un vault, scarica l'estensione Chrome o Firefox dalla pagina delle estensioni del browser (pacchetto macOS o Windows corrispondente al tuo sistema operativo), configura la Messaggistica nativa, quindi collega l'estensione.
Sincronizzazione opzionale (opzionale)
Sincronizzazione multi-dispositivo integrato (cloud QubKey o server self-hosted, abilitato in Impostazioni) o copia/ sincronizzazione manuale del file .rkvey crittografato (cartella cloud, unità USB).
Requisiti di sistema
Operating system
macOS (Apple Silicon) e Windows 10/11 (NSIS/MSI) disponibili per il download. Linux in sviluppo attivo: vedere le note di rilascio e la pagina di download del sito.
RAM
4 GB minimo — 8 GB consigliati. Argon2id utilizza 64 MB per sblocco; Una RAM insufficiente potrebbe rallentare l'apertura del caveau.
Disk space
200 MB per l'applicazione
WebView
WebView2 (Windows) o WebKit: in bundle su macOS/Linux tramite Tauri
Scaricamento
macOS
Apple Silicon (arm64) .dmg — fuori dal Mac App Store. Verifica l'hash SHA-256 nella pagina di download.
Finestre
Programmi di installazione NSIS/MSI per Windows 10/11 (x64 o x86): consulta la pagina dedicata per i pacchetti disponibili.
Linux
In sviluppo attivo: nessun download Linux ancora pubblicato.
Installazione della piattaforma
Scarica Apple Silicon (arm64) .dmg dalla pagina macOS
Verifica l'impronta digitale SHA-256 pubblicata, apri .dmg e trascina QubKey su /Applications
Al primo avvio: fare clic con il tasto destro del mouse → Apri se Gatekeeper mostra un avviso (app esterna al Mac App Store)
Concedere l'accesso al disco e alla cartella Documenti se macOS lo richiede
Controlla la pagina Windows per i programmi di installazione NSIS/MSI disponibili (x64 o x86)
Fare doppio clic sul programma di installazione e seguire la procedura guidata (scegliere la cartella di installazione)
Accetta l'installazione di WebView2 se richiesto (richiesto per l'interfaccia utente Tauri)
Avviare QubKey dal menu Start: consenti l'accesso ai file se Windows lo richiede
Linux
La versione Linux è in fase di sviluppo attiva. Sul sito non è ancora offerto alcun pacchetto AppImage, .deb o .rpm: segui la pagina di download per gli annunci.
Verifica dell'integrità
Integrità binaria
Verifica sempre la firma o l'hash SHA256 prima dell'installazione: questo garantisce che il file binario non sia stato manomesso tra la build e la tua macchina (catena di fornitura).
shasum -a 256 QubKey_2.0.0_aarch64.dmgConfrontare con l'hash nella pagina di download o in Note sulla versione (tabella per build).
Post-installazione
First vault
Crea il tuo deposito .rkvey e imposta la password principale
Estensione del browser
Installa l'estensione per il riempimento automatico
Sync
Esporta o sincronizza il tuo file .rkvey (facoltativo)
Risoluzione dei problemi
Missing WebView2 (Windows)
Tauri richiede WebView2 per visualizzare l'interfaccia utente. Scaricalo da microsoft.com/edge/webview2 se il programma di installazione non lo offriva.
Gatekeeper blocks (macOS)
Per build non autenticate: fare clic con il pulsante destro del mouse → Apri. In alternativa: xattr -cr /Applications/QubKey.app per rimuovere la quarantena.
Missing dependencies (Linux)
Tauri richiede webkit2gtk. Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1