Instalação
Instale o desktop QubKey no macOS, Windows e Linux – necessário para extensão e sincronização.
QubKey é um aplicativo nativo de desktop que forma o núcleo do ecossistema. Baixe o instalador para o seu sistema operacional e siga as etapas abaixo.
O ecossistema QubKey inclui o aplicativo de desktop (obrigatório — cofre, criptografia, gerenciamento) e a extensão do navegador (opcional — preenchimento automático via Native Messaging). Sincronização opcional entre seus próprios dispositivos pode complementar o modelo local (pasta na nuvem, cópia manual do arquivo .rkvey). O aplicativo de desktop deve ser instalado primeiro – a extensão depende disso.
Ordem de instalação
Aplicativo de desktop QubKey
Instale primeiro o aplicativo nativo: ele gerencia o cofre .rkvey, toda a criptografia (Argon2id, AEAD) e gerenciamento de segredos. Sem ele, a extensão não funciona.
Extensão do navegador (opcional)
Depois que o aplicativo de desktop estiver instalado e um cofre criado, baixe a extensão do Chrome ou do Firefox na página de extensões do navegador (pacote macOS ou Windows correspondente ao seu sistema operacional), configure o Native Messaging e conecte a extensão.
Sincronização opcional (opcional)
Sincronização integrada de dispositivos (nuvem QubKey ou servidor auto-hospedado, habilitado em configurações) ou cópia/sincronização manual do arquivo vários .rkvey criptografado (pasta na nuvem, unidade USB).
Requisitos do sistema
Operating system
macOS (Apple Silicon) e Windows 10/11 (NSIS/MSI) disponíveis para download. Linux em desenvolvimento ativo — veja as notas de lançamento e a página de download do site.
RAM
4 GB mínimo — 8 GB recomendado. Argon2id usa 64 MB por desbloqueio; RAM insuficiente pode retardar a abertura do cofre.
Disk space
200 MB para o aplicativo
WebView
WebView2 (Windows) ou WebKit — incluído no macOS/Linux via Tauri
Download
macOS
Apple Silicon (arm64) .dmg – fora da Mac App Store. Verifique o hash SHA-256 na página de download.
Windows
Instaladores NSIS/MSI para Windows 10/11 (x64 ou x86) — consulte a página dedicada para pacotes disponíveis.
Linux
Em desenvolvimento ativo — nenhum download do Linux foi publicado ainda.
Instalação da plataforma
Baixe o Apple Silicon (arm64) .dmg na página do macOS
Verifique a impressão digital SHA-256 publicada, abra .dmg e capture QubKey para /Applications
Na primeira inicialização: clique com o botão direito → Abrir se o Gatekeeper mostrar um aviso (aplicativo fora da Mac App Store)
Conceda acesso ao disco e à pasta Documentos se o macOS solicitar
Verifique a página do Windows para instaladores NSIS/MSI disponíveis (x64 ou x86)
Clique duas vezes no instalador e siga o assistente (escolha a pasta de instalação)
Aceite a instalação do WebView2 solicitado (obrigatório para Tauri UI)
Inicie o QubKey no menu Iniciar – permita o acesso ao arquivo se o Windows solicitar
Linux
A versão Linux está em desenvolvimento ativo. Nenhum pacote AppImage, .deb ou .rpm é oferecido no site ainda – siga a página de download para anúncios.
Verificação de integridade
Integridade binária
Sempre verifique a assinatura ou hash SHA256 antes de instalar — isso garante que o binário não foi adulterado entre a compilação e sua máquina (cadeia de suprimentos).
shasum -a 256 QubKey_2.0.0_aarch64.dmgCompare com o hash na página de download ou em Notas de versão (tabela por compilação).
Pós-instalação
First vault
Crie seu cofre .rkvey e defina a senha mestra
Extensão do navegador
Instale a extensão para preenchimento automático
Sync
Exporte ou sincronize seu arquivo .rkvey (opcional)
Solução de problemas
Missing WebView2 (Windows)
Tauri requer WebView2 para exibir a IU. Baixe-o em microsoft.com/edge/webview2 se o instalador não o oferecer.
Gatekeeper blocks (macOS)
Para construções não autenticadas: clique com o botão direito → Abrir. Alternativamente: xattr -cr /Applications/QubKey.app para remover a quarentena.
Missing dependencies (Linux)
Tauri requer webkit2gtk. Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1