Choisissez comment installer le serveur
| Méthode | Idéal pour | Prérequis |
|---|---|---|
| 1. Image VM prête à l'emploi | Importer, démarrer, se connecter — Debian, PostgreSQL et PassZit prêts | VMware, VirtualBox, Proxmox/KVM ou Hyper-V |
| 2. ISO d'appliance | Une nouvelle VM ou un serveur physique, sans intervention | Accès Internet pendant l'installation |
| 3. Script d'installation | Un serveur Debian, Ubuntu, AlmaLinux ou Rocky Linux existant | Accès root et Internet |
| 4. Paquets à la main | Votre propre PostgreSQL, gestion de configuration | Le paquet deb ou rpm de la version |
Le serveur a besoin de 2 vCPU, 2 Go de RAM et d'un disque de 16 Go. Les navigateurs y accèdent sur TCP 8443. Pour les extensions, il lui faut un nom et un certificat reconnu par les navigateurs — PassZit en obtient un auprès de Let's Encrypt ou utilise le vôtre (Paramètres → Certificat).
1. Image VM prête à l'emploi
VMware ESXi, Workstation, VirtualBox
ESXi Host Client : Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere : Deploy OVF Template.
Proxmox VE et KVM
Créez une VM sans disque (2 vCPU, 2 Go de RAM, réseau VirtIO), importez le disque et attachez-le comme disque de démarrage SCSI.
Hyper-V (génération 1)
Décompressez, créez une VM de génération 1 avec 2 Go de RAM et choisissez le VHDX comme disque.
Sur Proxmox VE, après avoir copié l'image sur le nœud :
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Démarrez la VM : son écran affiche l'adresse de la console et un jeton de configuration. Ouvrez https://<adresse>:8443, acceptez une fois le certificat autosigné, saisissez le jeton et créez le premier administrateur avec la connexion à deux facteurs. Sur l'écran de la VM, connectez-vous en tant que pzadmin (premier mot de passe passzit, à changer à la première connexion) : un menu règle le réseau, le nom du serveur et le fuseau horaire, affiche le jeton de configuration et restaure les sauvegardes. Seuls les ports 22 (SSH) et 8443 sont ouverts.
2. ISO d'appliance
passzit-appliance.iso — démarrez une VM ou un serveur dessus. Au bout de 5 secondes, l'installation automatique commence : elle efface le premier disque, installe Debian, PostgreSQL et PassZit depuis le réseau, puis affiche l'adresse de la console et le jeton de configuration.
3. Script d'installation
Sur Debian 12+, Ubuntu 22.04+, AlmaLinux ou Rocky Linux 9+ (x86-64 ou ARM64), en root :
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. Relancez-le pour mettre à jour. Options (avec sh -s -- en cas de pipe) : --version X, --db postgres://…, --no-auto-updates (laisse désactivées les mises à jour de sécurité automatiques du système), --source URL. Pour le lire d'abord :
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Paquets et autres fichiers
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Définissez PASSZIT_DB dans /etc/passzit/server.env, puis systemctl start passzit-server. Le jeton de configuration se trouve dans /var/lib/passzit/setup-token.txt. Ces fichiers portent la version dans leur nom et figurent sur la page de la version :
| Fichier | Contenu |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | Le serveur, pour une installation à la main (x86-64 et ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | L'extension de navigateur pour une installation à la main (voir ci-dessous) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | La ligne de commande passzit pour Linux, Windows et macOS |
passzit-helper-X-linux-amd64, -arm64 | Ouvre les connexions distantes depuis l'extension sous Linux ; sous Windows, c'est le MaxZit Launcher (à télécharger sur la page Launcher de votre serveur) |
| SHA256SUMS | Sommes de contrôle des programmes et paquets |
| SHA256SUMS-appliance | Sommes de contrôle des images VM et de l'ISO |
Extension de navigateur
L'extension remplit et enregistre les identifiants dans Chrome, Edge, Opera, Brave, Vivaldi et Firefox. 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.
Votre serveur PassZit propose la même chose : Extensions de navigateur dans le menu du coffre web renvoie vers la boutique de votre navigateur et propose les paquets de sa propre version pour une installation à la main. Cliquez ensuite sur l'icône PassZit, saisissez l'adresse de votre serveur et choisissez Connecter avec le coffre web — aucun mot de passe n'est tapé dans l'extension.
Vérifier un téléchargement
sha256sum -c SHA256SUMS --ignore-missing # programmes et paquets
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, zip VHDX, ISO
Le serveur et le script d'installation vérifient le manifeste signé de la version avant toute installation ; voir Sécurité.
Mises à jour
Paramètres → Mises à jour et serveur affiche la version en cours et la plus récente et installe les mises à jour, éventuellement automatiquement à une heure choisie. Seules les versions signées avec la clé de publication de PassZit sont installées ; le serveur sauvegarde d'abord sa base de données et son programme et les rétablit si la nouvelle version ne démarre pas. Le canal Testing propose des versions candidates pour un serveur de test. Paramètres → Sauvegarde de la console conserve des sauvegardes quotidiennes chiffrées de la base de données, de la clé secrète du serveur et du certificat, pour une restauration sur une nouvelle machine.