Qué cubre esta guía
PassZit es un gestor de contraseñas gratuito y de código abierto (AGPLv3) que funciona en su propio servidor. Cada usuario tiene una bóveda cifrada de extremo a extremo para inicios de sesión, códigos de un solo uso, notas seguras, tarjetas, claves SSH y archivos; los equipos comparten bóvedas con permisos por persona. El servidor solo guarda texto cifrado. Si está comparando herramientas porque buscó una alternativa autoalojada a Bitwarden, esta guía muestra cómo son en la práctica la instalación y la puesta en marcha de PassZit.
- Qué necesita
- Instalar el servidor
- Primer inicio de sesión y primer administrador
- Un certificado en el que confíen los navegadores
- Invitar a su equipo
- Contraseña maestra y clave de recuperación
- Instalar la extensión del navegador
- Importar contraseñas de otro programa
- Cómo funciona el cifrado
- Copias de seguridad del servidor
- Actualizaciones
- Límites que conviene conocer
- Próximos pasos
Qué necesita
- Una máquina virtual en VMware, VirtualBox, Proxmox VE/KVM o Hyper-V, o un servidor físico, con 2 vCPU, 2 GB de RAM y un disco de 16 GB — o un servidor existente de 64 bits con Debian 12+, Ubuntu 22.04+, AlmaLinux o Rocky Linux 9+ (x86-64 o ARM64).
- Los navegadores acceden al servidor por TCP 8443. PostgreSQL lo configuran el script de instalación y las imágenes.
- Para las extensiones del navegador: un nombre DNS para el servidor y un certificado en el que confíen los navegadores (vea más abajo).
- Opcionalmente, un servidor SMTP para que PassZit envíe invitaciones y avisos por correo electrónico.
Instalar el servidor
Hay cuatro formas; todas están en la página de descarga y cada versión está firmada.
| Forma | Ideal para |
|---|---|
| Imagen de VM: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V generación 1) | Importar, arrancar, iniciar sesión — Debian, PostgreSQL y PassZit listos |
| ISO del appliance | Una VM nueva o un servidor físico; la instalación desatendida borra el primer disco |
| Script de instalación | Un servidor Debian, Ubuntu, AlmaLinux o Rocky Linux existente |
| Paquetes (deb, rpm; amd64, arm64) | Su propio PostgreSQL y gestión de la configuración |
Imagen de VM o ISO: arranque la VM. Su pantalla muestra la dirección de la consola y el token de configuración. En la consola de la VM puede iniciar sesión como pzadmin (primera contraseña passzit, se cambia en el primer inicio de sesión): un menú configura la red, el nombre del servidor y la zona horaria, vuelve a mostrar el token y restaura copias de seguridad. Solo están abiertos los puertos 22 (SSH) y 8443.
Script de instalación: como root en el servidor:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
El script instala PostgreSQL, descarga la versión más reciente, comprueba su firma, crea una base de datos con una contraseña aleatoria, inicia el servicio y muestra la dirección y el token de configuración. Opciones como --version, --db (una base de datos PostgreSQL existente) o --no-auto-updates se pasan con sh -s --.
Paquetes: instale el deb o el rpm, defina PASSZIT_DB en /etc/passzit/server.env y ejecute systemctl start passzit-server. El token de configuración está en /var/lib/passzit/setup-token.txt.
Primer inicio de sesión y primer administrador
- Abra
https://<servidor>:8443. Un servidor nuevo usa un certificado autofirmado; el navegador avisa una vez — acéptelo. - Introduzca el Token de configuración, su dirección de correo y una contraseña maestra. Su navegador crea ahora sus claves; tarda un segundo. Esta primera cuenta es el administrador.
- Escanee el código QR con una aplicación de autenticación (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). El inicio de sesión en dos pasos es obligatorio para todas las cuentas. Guarde los diez códigos de recuperación; cada uno sustituye a la aplicación una vez.
- Cree una clave de recuperación (vea más abajo) y añada su primer inicio de sesión con Nuevo elemento.
Más adelante, en Mi cuenta, puede añadir llaves de seguridad (YubiKey y otras) o una llave de acceso de su dispositivo como segundo factor.
Un certificado en el que confíen los navegadores
Las extensiones del navegador rechazan los certificados autofirmados, así que dé al servidor uno real antes de desplegar la extensión. En Ajustes → Certificado, suba un certificado (de la CA de su empresa o comprado; PEM con los certificados intermedios y la clave privada) o elija Let's Encrypt. Let’s Encrypt necesita un nombre DNS público y lo comprueba por el puerto 80 del servidor o mediante un registro DNS en Cloudflare — lo segundo también sirve para un servidor accesible solo dentro de su red. El certificado se usa de inmediato, sin reiniciar; el DNS de su red debe apuntar el nombre al servidor.
Invitar a su equipo
Las cuentas solo se crean por invitación. En Usuarios → Invitar a un usuario introduzca la dirección de correo y el rol (Usuario o Administrador). PassZit muestra el enlace de invitación una sola vez; envíeselo a la persona. El enlace funciona una vez y durante 7 días por defecto. Si configuró un servidor SMTP en Ajustes → Correo electrónico, marque Enviar también la invitación por correo electrónico y PassZit la envía por usted.
La persona invitada elige una contraseña maestra y configura el inicio de sesión en dos pasos, igual que usted. Los administradores pueden desactivar usuarios, restablecer un segundo factor perdido y retirar invitaciones abiertas. Para compartir contraseñas, cree una bóveda compartida y dé acceso a personas o grupos.
Las cuentas de la empresa se conectan en Ajustes → Inicio de sesión de empresa: inicio de sesión único con OpenID Connect o SAML 2.0, y Active Directory / LDAP. La contraseña maestra siempre se mantiene, porque es la clave de la bóveda.
Contraseña maestra y clave de recuperación
La contraseña maestra nunca sale del navegador del usuario. Ese es el sentido del cifrado de extremo a extremo, y tiene una consecuencia: nadie — ni el administrador ni MaxZit — puede abrir una bóveda sin la contraseña maestra o la clave de recuperación. Los administradores no pueden ver ni restablecer contraseñas maestras.
- Una frase de contraseña de cuatro a seis palabras aleatorias es fácil de recordar y difícil de adivinar. La política de la bóveda fija una longitud mínima (12 caracteres por defecto).
- En Mi cuenta, Crear una clave de recuperación muestra una clave de 32 letras y cifras, solo una vez. Imprímala o anótela y guárdela fuera de línea — no en la bóveda ni junto al teléfono.
- Con la clave de recuperación y un código de la aplicación de autenticación, un usuario que olvidó su contraseña maestra define una nueva en la página de inicio de sesión. Sin clave de recuperación la bóveda se pierde; el administrador solo puede eliminar la cuenta y volver a invitar a la persona con una bóveda vacía. La lista de usuarios muestra quién ha creado una clave de recuperación.
Pida a todos que creen su clave de recuperación el primer día.
Instalar la extensión del navegador
La extensión rellena inicios de sesión y códigos de un solo uso solo en el sitio al que pertenecen, ofrece guardar inicios de sesión nuevos y modificados, rellena tarjetas y direcciones en formularios de pago y envío y genera contraseñas. Instálela desde la tienda de su navegador, que la mantiene actualizada:
- Chrome Web Store — Chrome, Brave, Opera y Vivaldi
- Firefox Add-ons — Firefox 128 o posterior
- Microsoft Edge Add-ons — Microsoft Edge
Los enlaces están en la página de descarga. El servidor PassZit ofrece lo mismo: Extensiones del navegador en el menú de la bóveda web muestra Instalar con un clic con la tienda del navegador que usa, y los paquetes de su propia versión para instalarlos a mano.
- Haga clic en el icono de PassZit, introduzca solo la dirección de su servidor (por ejemplo
https://vault.example.com) y haga clic en Conectar con la bóveda web. Permita que el navegador deje a PassZit comunicarse con ese servidor. Un puerto en la dirección, como:8443, funciona en todos los navegadores, también en Firefox. - Se abre la bóveda web; inicie sesión allí si aún no lo ha hecho.
- La bóveda pregunta si debe conectar la extensión en este navegador — haga clic en Conectar. En la extensión no se escribe ninguna contraseña ni código.
La bóveda web y la extensión comparten un único desbloqueo: desbloquee una y la otra se abre también; bloquee una y se bloquean ambas.
Importar contraseñas de otro programa
Cada usuario importa en su propia bóveda. Exporte primero desde el programa anterior y luego elija Herramientas → Importar en la bóveda y el archivo. PassZit reconoce el formato, muestra cuántos elementos y carpetas encontró y cuántos ya están en la bóveda, y permite conservar las carpetas del archivo y omitir duplicados.
| Desde | Exportar allí |
|---|---|
| Chrome, Edge, Brave, Opera, Vivaldi | Password manager → Settings → Export passwords (CSV) |
| Firefox | about:logins → … → Export passwords (CSV) |
| Safari | File → Export → Passwords (CSV) |
| Bitwarden | Tools → Export vault → .json o .csv, no la variante cifrada |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV o XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
El archivo se lee en el navegador; el servidor recibe los elementos solo cifrados. Se transfieren inicios de sesión, notas, sitios web, campos propios, carpetas, favoritos y secretos TOTP (de Bitwarden también tarjetas, identidades y claves SSH). Los archivos adjuntos no forman parte de estas exportaciones. Elimine después el archivo exportado — contiene las contraseñas sin cifrar.
Cómo funciona el cifrado
El navegador deriva una clave maestra de la contraseña maestra con Argon2id (64 MiB, 3 pasadas). De ella salen dos claves: una clave de autenticación que se envía al iniciar sesión — el servidor solo guarda un hash argon2id de ella — y una clave de envoltura que desbloquea la clave de cuenta aleatoria del usuario. Cada elemento, incluidos su nombre, usuario, sitios web y notas, se cifra con AES-256-GCM bajo la clave de su bóveda; las bóvedas compartidas tienen su propia clave, sellada para la clave X25519 de cada miembro. El servidor ve texto cifrado, identificadores, tamaños y marcas de tiempo, nunca la contraseña maestra ni una clave que pudiera usar. Los detalles están en la página de seguridad y en docs/ARCHITECTURE.md del repositorio.
Copias de seguridad del servidor
Ajustes → Copia de la consola escribe cada día (y a petición con Hacer copia ahora) una copia en /var/lib/passzit/backups: la base de datos con todas las bóvedas, la clave secreta del servidor y el certificado de la consola — todo lo que necesita un servidor nuevo. Una copia siempre está cifrada con una frase de contraseña que usted define; guárdela en otro lugar. Cada copia puede copiarse además a una carpeta SFTP en otro servidor. Para restaurar, use el menú del appliance, o detenga el servicio y ejecute passzit-server -restore como describe la guía integrada en la consola.
Actualizaciones
Ajustes → Actualizaciones y servidor muestra la versión en ejecución y la más reciente. La instalación comprueba de nuevo la firma, hace copia de la base de datos y del programa, instala la actualización y comprueba que el servidor vuelve — si no, restaura por sí sola la versión anterior y la base de datos. Ahí también se activa la instalación automática a una hora elegida. El canal Estable recibe las versiones; Testing ofrece además versiones candidatas, para un servidor de pruebas. En una instalación con script, volver a ejecutar el instalador también actualiza PassZit y conserva todos los datos.
Límites que conviene conocer
- PassZit está en desarrollo activo: la primera versión pública fue la 0.9.0 en noviembre de 2026, y salen versiones nuevas a menudo.
- No hay aplicación móvil nativa. En el teléfono, la bóveda web puede añadirse a la pantalla de inicio y se abre en su propia ventana, pero no se guarda nada para usar sin conexión — sin el servidor verá una página «offline».
- Una contraseña maestra olvidada sin clave de recuperación no la puede recuperar nadie.
- Las extensiones del navegador necesitan un certificado de confianza e inician sesión con la contraseña maestra y el código de autenticación — no con inicio de sesión único.
- Como en toda bóveda web, su JavaScript viene del servidor, de modo que un servidor totalmente comprometido podría servir código modificado; la extensión trae su propio código.
- No hay imagen Docker; instale con una imagen, el script o los paquetes. La guía integrada en la consola está en inglés y serbio.
Próximos pasos
Descargue PassZit, vea todas las funciones — bóvedas compartidas, enlaces secretos, acceso de emergencia, conexiones remotas, la línea de comandos — o lea la guía integrada en la consola (documentación). Cómo configurar bóvedas compartidas para un equipo lo explica la guía Compartir contraseñas con el equipo. Las preguntas son bienvenidas en GitHub Discussions. Las empresas pueden contratar soporte comercial de MaxZit (solo en inglés).