Ce que couvre ce guide
PassZit est un gestionnaire de mots de passe gratuit et open source (AGPLv3) qui fonctionne sur votre propre serveur. Chaque utilisateur dispose d’un coffre chiffré de bout en bout pour ses identifiants, codes à usage unique, notes sécurisées, cartes, clés SSH et fichiers ; les équipes partagent des coffres avec des droits par personne. Le serveur ne stocke que du texte chiffré. Si vous comparez des outils parce que vous avez cherché une alternative auto-hébergée à Bitwarden, ce guide montre à quoi ressemblent concrètement l’installation et le déploiement de PassZit.
- Ce qu’il vous faut
- Installer le serveur
- Première connexion et premier administrateur
- Un certificat reconnu par les navigateurs
- Inviter votre équipe
- Mot de passe principal et clé de récupération
- Installer l’extension de navigateur
- Importer les mots de passe d’un autre programme
- Comment fonctionne le chiffrement
- Sauvegarder le serveur
- Mises à jour
- Limites à connaître
- Étapes suivantes
Ce qu’il vous faut
- Une machine virtuelle sur VMware, VirtualBox, Proxmox VE/KVM ou Hyper-V, ou un serveur physique, avec 2 vCPU, 2 Go de RAM et un disque de 16 Go — ou un serveur 64 bits existant sous Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64 ou ARM64).
- Les navigateurs joignent le serveur sur le port TCP 8443. PostgreSQL est installé par le script et par les images.
- Pour les extensions de navigateur : un nom DNS pour le serveur et un certificat reconnu par les navigateurs (voir plus bas).
- En option, un serveur SMTP pour que PassZit envoie invitations et avis par e-mail.
Installer le serveur
Il existe quatre méthodes ; toutes figurent sur la page de téléchargement, et chaque version est signée.
| Méthode | Idéale pour |
|---|---|
| Image de VM : OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V génération 1) | Importer, démarrer, se connecter — Debian, PostgreSQL et PassZit sont prêts |
| ISO de l’appliance | Une nouvelle VM ou un serveur physique ; l’installation automatique efface le premier disque |
| Script d’installation | Un serveur Debian, Ubuntu, AlmaLinux ou Rocky Linux existant |
| Paquets (deb, rpm ; amd64, arm64) | Votre propre PostgreSQL et votre gestion de configuration |
Image de VM ou ISO : démarrez la VM. Son écran affiche l’adresse de la console et le jeton de configuration. Sur la console de la VM, vous pouvez vous connecter en tant que pzadmin (premier mot de passe passzit, changé à la première connexion) : un menu règle le réseau, le nom du serveur et le fuseau horaire, affiche à nouveau le jeton et restaure les sauvegardes. Seuls les ports 22 (SSH) et 8443 sont ouverts.
Script d’installation : en root sur le serveur :
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Le script installe PostgreSQL, télécharge la dernière version, vérifie sa signature, crée une base de données avec un mot de passe aléatoire, démarre le service et affiche l’adresse et le jeton de configuration. Les options comme --version, --db (une base PostgreSQL existante) ou --no-auto-updates se passent avec sh -s --.
Paquets : installez le deb ou le rpm, définissez PASSZIT_DB dans /etc/passzit/server.env et lancez systemctl start passzit-server. Le jeton de configuration se trouve dans /var/lib/passzit/setup-token.txt.
Première connexion et premier administrateur
- Ouvrez
https://<serveur>:8443. Un serveur neuf utilise un certificat auto-signé ; le navigateur avertit une fois — acceptez-le. - Saisissez le Jeton de configuration, votre adresse e-mail et un mot de passe principal. Votre navigateur crée alors vos clés ; cela prend une seconde. Ce premier compte est l’administrateur.
- Scannez le code QR avec une application d’authentification (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). La connexion à deux facteurs est obligatoire pour chaque compte. Conservez les dix codes de récupération ; chacun remplace l’application une fois.
- Créez une clé de récupération (voir plus bas) et ajoutez votre premier identifiant avec Nouvel élément.
Plus tard, sous Mon compte, vous pouvez ajouter des clés de sécurité (YubiKey et autres) ou une clé d’accès de votre appareil comme second facteur.
Un certificat reconnu par les navigateurs
Les extensions de navigateur refusent les certificats auto-signés : donnez au serveur un vrai certificat avant de déployer l’extension. Sous Paramètres → Certificat, importez un certificat (de l’AC de votre entreprise ou acheté ; PEM avec les certificats intermédiaires et la clé privée) ou choisissez Let's Encrypt. Let’s Encrypt exige un nom DNS public et le vérifie via le port 80 du serveur ou via un enregistrement DNS chez Cloudflare — la seconde méthode fonctionne aussi pour un serveur joignable uniquement dans votre réseau. Le certificat est utilisé immédiatement, sans redémarrage ; le DNS de votre réseau doit faire pointer le nom vers le serveur.
Inviter votre équipe
Les comptes ne se créent que sur invitation. Sous Utilisateurs → Inviter un utilisateur, saisissez l’adresse e-mail et le rôle (Utilisateur ou Administrateur). PassZit affiche le lien d’invitation une seule fois ; envoyez-le à la personne. Le lien fonctionne une fois et pendant 7 jours par défaut. Si vous avez configuré un serveur SMTP sous Paramètres → E-mail, cochez Envoyer aussi l'invitation par e-mail et PassZit l’envoie pour vous.
La personne invitée choisit un mot de passe principal et configure la connexion à deux facteurs, comme vous. Les administrateurs peuvent désactiver des utilisateurs, réinitialiser un second facteur perdu et retirer des invitations ouvertes. Pour partager des mots de passe, créez un coffre partagé et donnez-y accès à des personnes ou à des groupes.
Les comptes de l’entreprise se connectent sous Paramètres → Connexion d'entreprise : authentification unique avec OpenID Connect ou SAML 2.0, et Active Directory / LDAP. Le mot de passe principal reste toujours, car c’est la clé du coffre.
Mot de passe principal et clé de récupération
Le mot de passe principal ne quitte jamais le navigateur de l’utilisateur. C’est tout l’intérêt du chiffrement de bout en bout, avec une conséquence : personne — ni l’administrateur, ni MaxZit — ne peut ouvrir un coffre sans le mot de passe principal ou la clé de récupération. Les administrateurs ne peuvent ni voir ni réinitialiser les mots de passe principaux.
- Une phrase de passe de quatre à six mots aléatoires est facile à retenir et difficile à deviner. La politique du coffre fixe une longueur minimale (12 caractères par défaut).
- Sous Mon compte, Créer une clé de récupération affiche une clé de 32 lettres et chiffres, une seule fois. Imprimez-la ou notez-la et conservez-la hors ligne — pas dans le coffre ni à côté de votre téléphone.
- Avec la clé de récupération et un code de l’application d’authentification, un utilisateur qui a oublié son mot de passe principal en définit un nouveau sur la page de connexion. Sans clé de récupération, le coffre est perdu ; l’administrateur peut seulement supprimer le compte et réinviter la personne avec un coffre vide. La liste des utilisateurs indique qui a créé une clé de récupération.
Demandez à chacun de créer sa clé de récupération dès le premier jour.
Installer l’extension de navigateur
L’extension remplit les identifiants et les codes à usage unique uniquement sur le site auquel ils appartiennent, propose d’enregistrer les identifiants nouveaux et modifiés, remplit les cartes et adresses dans les formulaires de paiement et de livraison et génère des mots de passe. Installez-la depuis la boutique de votre navigateur, qui la tient à jour :
- Chrome Web Store — Chrome, Brave, Opera et Vivaldi
- Firefox Add-ons — Firefox 128 ou plus récent
- Microsoft Edge Add-ons — Microsoft Edge
Les liens se trouvent sur la page de téléchargement. Le serveur PassZit propose la même chose : Extensions de navigateur dans le menu du coffre web affiche Installer en un clic avec la boutique de votre navigateur, ainsi que les paquets de sa propre version pour une installation manuelle.
- Cliquez sur l’icône PassZit, saisissez uniquement l’adresse de votre serveur (par exemple
https://vault.example.com) et cliquez sur Connecter avec le coffre web. Autorisez le navigateur à laisser PassZit communiquer avec ce serveur. Un port dans l’adresse, comme:8443, fonctionne dans tous les navigateurs, Firefox compris. - Le coffre web s’ouvre ; connectez-vous-y si ce n’est pas déjà fait.
- Le coffre demande s’il faut connecter l’extension dans ce navigateur — cliquez sur Connecter. Aucun mot de passe ni code n’est saisi dans l’extension.
Le coffre web et l’extension partagent un seul déverrouillage : déverrouillez l’un et l’autre s’ouvre aussi, verrouillez l’un et les deux se verrouillent.
Importer les mots de passe d’un autre programme
Chaque utilisateur importe dans son propre coffre. Exportez d’abord depuis l’ancien programme, puis choisissez Outils → Importer dans le coffre et sélectionnez le fichier. PassZit reconnaît le format, indique combien d’éléments et de dossiers il a trouvés et combien sont déjà dans le coffre, et permet de garder les dossiers du fichier et d’ignorer les doublons.
| Depuis | Export là-bas |
|---|---|
| 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 ou .csv, pas la variante chiffrée |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV ou XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
Le fichier est lu dans le navigateur ; le serveur ne reçoit les éléments que chiffrés. Sont repris les identifiants, notes, sites web, champs personnalisés, dossiers, favoris et secrets TOTP (de Bitwarden aussi les cartes, identités et clés SSH). Les fichiers joints ne font pas partie de ces exports. Supprimez ensuite le fichier d’export — il contient les mots de passe en clair.
Comment fonctionne le chiffrement
Le navigateur dérive une clé maîtresse du mot de passe principal avec Argon2id (64 Mio, 3 passes). Elle donne deux clés : une clé d’authentification envoyée à la connexion — le serveur n’en stocke qu’un hachage argon2id — et une clé d’enveloppe qui déverrouille la clé de compte aléatoire de l’utilisateur. Chaque élément, y compris son nom, son identifiant, ses sites web et ses notes, est chiffré en AES-256-GCM avec la clé de son coffre ; les coffres partagés ont leur propre clé, scellée pour la clé X25519 de chaque membre. Le serveur voit du texte chiffré, des identifiants, des tailles et des horodatages, jamais le mot de passe principal ni une clé qu’il pourrait utiliser. Les détails figurent sur la page sécurité et dans docs/ARCHITECTURE.md du dépôt.
Sauvegarder le serveur
Paramètres → Sauvegarde de la console écrit chaque jour (et sur demande avec Sauvegarder maintenant) une sauvegarde dans /var/lib/passzit/backups : la base de données avec tous les coffres, la clé secrète du serveur et le certificat de la console — tout ce dont un nouveau serveur a besoin. Une sauvegarde est toujours chiffrée avec une phrase secrète que vous définissez ; conservez-la ailleurs. Chaque sauvegarde peut aussi être copiée dans un dossier SFTP sur un autre serveur. Pour restaurer, utilisez le menu de l’appliance, ou arrêtez le service et lancez passzit-server -restore comme le décrit le guide intégré à la console.
Mises à jour
Paramètres → Mises à jour et serveur affiche la version en cours et la plus récente. L’installation vérifie à nouveau la signature, sauvegarde la base et le programme, installe la mise à jour et vérifie que le serveur redémarre — sinon, elle remet d’elle-même l’ancienne version et la base. L’installation automatique à une heure choisie s’active au même endroit. Le canal Stable reçoit les versions ; Testing propose aussi les versions candidates, pour un serveur de test. Sur une installation par script, relancer le script met aussi PassZit à jour en conservant toutes les données.
Limites à connaître
- PassZit est en développement actif : la première version publique, 0.9.0, date de novembre 2026, et de nouvelles versions sortent souvent.
- Il n’existe pas d’application mobile native. Sur un téléphone, le coffre web peut être ajouté à l’écran d’accueil et s’ouvre dans sa propre fenêtre, mais rien n’est stocké pour un usage hors ligne — sans le serveur, vous voyez une page « hors ligne ».
- Un mot de passe principal oublié sans clé de récupération ne peut être récupéré par personne.
- Les extensions de navigateur exigent un certificat reconnu et se connectent avec le mot de passe principal et le code d’authentification — pas par authentification unique.
- Comme pour tout coffre web, son JavaScript vient du serveur ; un serveur entièrement compromis pourrait donc servir du code modifié. L’extension apporte son propre code.
- Il n’y a pas d’image Docker ; installez avec une image, le script ou les paquets. Le guide intégré à la console existe en anglais et en serbe.
Étapes suivantes
Téléchargez PassZit, découvrez toutes les fonctionnalités — coffres partagés, liens secrets, accès d’urgence, connexions distantes, ligne de commande — ou lisez le guide intégré à la console (documentation). La mise en place de coffres partagés pour une équipe est décrite dans le guide Partager des mots de passe en équipe. Vos questions sont les bienvenues dans les GitHub Discussions. Les entreprises peuvent obtenir un support commercial de MaxZit (en anglais uniquement).