Primeros pasos

Instalación

Instale el escritorio QubKey en macOS, Windows y Linux; es necesario para la extensión y sincronización.

QubKey es una aplicación de escritorio nativa que forma el núcleo del ecosistema. Descargue el instalador para su sistema operativo y siga los pasos a continuación.

El ecosistema QubKey incluye la aplicación de escritorio (obligatoria: bóveda, criptografía, administración) y la extensión del navegador (opcional: autocompletar mediante mensajería nativa). La sincronización opcional entre sus propios dispositivos puede complementar el modelo local primero (carpeta en la nube, copia manual del.rkveyarchivo). Primero se debe instalar la aplicación de escritorio; la extensión depende de ello.

Orden de instalación

Aplicación de escritorio QubKey

Instale primero la aplicación nativa: gestiona la.rkveybóveda, toda la criptografía (Argon2id, AEAD) y gestión de secretos. Sin él, la extensión no funciona.

Extensión del navegador (opcional)

Una vez instalada la aplicación de escritorio y creada una bóveda, descargue la extensión Chrome o Firefox desde la página de extensiones del navegador (paquete de macOS o Windows que coincida con su sistema operativo), configure Mensajería nativa y luego conecte la extensión.

Sincronización opcional (opcional)

Sincronización multidispositivo incorporado (nube QubKey: autohospedaje próximamente como descarga, habilitado en Configuración) o copia/sincronización manual del archivo cifrado.rkveyarchivo (carpeta en la nube, unidad USB).

Requisitos del sistema

Operating system

macOS (Apple Silicon) y Windows 10/11 (NSIS/MSI) disponibles para descargar. Linux en desarrollo activo: consulte las notas de la versión y la página de descarga del sitio.

RAM

4 GB mínimo — 8 GB recomendado. Argon2id usa 64 MB por desbloqueo; Una RAM insuficiente puede ralentizar la apertura de la bóveda.

Disk space

200 MB para la aplicación

WebView

WebView2 (Windows) o WebKit: incluido en macOS/Linux a través de Tauri

Descargar

Instalación de plataforma

Descargue Apple Silicon (arm64).dmgdesde la página de MacOS

Verifique la huella digital SHA-256 publicada, abra el.dmgy arrastre QubKey a/Applications

En el primer inicio: haga clic derecho → Abrir si Gatekeeper muestra una advertencia (aplicación fuera de Mac App Store)

Conceder acceso al disco y a la carpeta Documentos si macOS lo solicita

Consulte la página de Windows para conocer los instaladores NSIS/MSI disponibles (x64 o x86)

Haga doble clic en el instalador y siga el asistente (elija la carpeta de instalación)

Acepte la instalación de WebView2 si se le solicita (requerido para la interfaz de usuario de Tauri)

Inicie QubKey desde el menú Inicio: permita el acceso a archivos si Windows lo solicita

Linux

La versión Linux está en desarrollo activo. Sin imagen de aplicación,.deb, vaya.rpmEl paquete aún se ofrece en el sitio; Siga la página de descargas para ver los anuncios.

Verificación de integridad

integridad binaria

Verifique siempre la firma o el hash SHA256 antes de la instalación; Esto garantiza que el binario no haya sido manipulado entre la compilación y su máquina (cadena de suministro).

shasum -a 256 QubKey_2.0.0_aarch64.dmg

Compárelo con el hash en la pagina de descarga o en Notas de la versión (tabla por compilación).

Post-instalación

Solución de problemas

Missing WebView2 (Windows)

Tauri requiere WebView2 para mostrar la interfaz de usuario. Descárguelo de microsoft.com/edge/webview2 si el instalador no lo ofrece.

Gatekeeper blocks (macOS)

Para compilaciones no notariadas: haga clic derecho → Abrir. Alternativamente:xattr -cr /Applications/QubKey.apppara quitar la cuarentena.

Missing dependencies (Linux)

Tauri requiere webkit2gtk. Debian/Ubuntu:sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1