Choose how to install the server
| Way | Best for | Needs |
|---|---|---|
| 1. Ready-made VM image | Import, start, sign in — Debian, PostgreSQL and PassZit ready | VMware, VirtualBox, Proxmox/KVM or Hyper-V |
| 2. Appliance ISO | A new VM or a physical server, unattended | Internet access during installation |
| 3. Install script | An existing Debian, Ubuntu, AlmaLinux or Rocky Linux server | Root and internet access |
| 4. Packages by hand | Your own PostgreSQL, configuration management | The deb or rpm package of the release |
The server needs 2 vCPU, 2 GB RAM and a 16 GB disk. Browsers reach it on TCP 8443. For the browser extensions it needs a name and a certificate the browsers trust — PassZit gets one from Let's Encrypt or uses yours (Settings → Certificate).
1. Ready-made VM image
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 and KVM
Create a VM without a disk (2 vCPU, 2 GB RAM, VirtIO network), import the disk, attach it as SCSI boot disk.
Hyper-V (generation 1)
Unzip, create a generation 1 VM with 2 GB RAM and choose the VHDX as its disk.
On Proxmox VE, after copying the image to the node:
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Start the VM: its screen shows the console address and a setup token. Open https://<address>:8443, accept the self-signed certificate once, enter the token and create the first administrator with two-factor sign-in. On the VM's screen, sign in as pzadmin (first password passzit, changed at the first sign-in): a menu sets the network, the server name and the time zone, shows the setup token and restores backups. Only ports 22 (SSH) and 8443 are open.
2. Appliance ISO
passzit-appliance.iso — boot a VM or server from it. After 5 seconds the unattended installation starts: it erases the first disk, installs Debian, PostgreSQL and PassZit from the network, and then shows the console address and the setup token.
3. Install script
On Debian 12+, Ubuntu 22.04+, AlmaLinux or Rocky Linux 9+ (x86-64 or ARM64), as root:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
The script installs PostgreSQL, downloads the newest release, verifies its signature, creates a database with a random password, starts the service and prints the address and the setup token. Run it again to update. Options (with sh -s -- when piped): --version X, --db postgres://…, --no-auto-updates (leave the system's automatic security updates off), --source URL. To read it first:
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Packages and other files
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Set PASSZIT_DB in /etc/passzit/server.env, then systemctl start passzit-server. The setup token is in /var/lib/passzit/setup-token.txt. These files carry the version in their name and are listed on the release page:
| File | What |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | The server, for installation by hand (x86-64 and ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | The browser extension for installation by hand (see below) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | The passzit command line for Linux, Windows and macOS |
passzit-helper-X-linux-amd64, -arm64 | Opens remote connections from the extension on Linux; on Windows the MaxZit Launcher does it (download it from your server's Launcher page) |
| SHA256SUMS | Checksums of the programs and packages |
| SHA256SUMS-appliance | Checksums of the VM images and the ISO |
Browser extension
The extension fills and saves logins in Chrome, Edge, Opera, Brave, Vivaldi and Firefox. Install it from the store of your browser, which keeps it up to date:
Chrome Web Store
Chrome, Brave, Opera and Vivaldi.
Firefox Add-ons
Firefox 128 or newer.
Microsoft Edge Add-ons
Microsoft Edge.
Your PassZit server offers the same: Browser extensions in the web vault's menu links to the store of your browser and offers the packages of its own version for installation by hand. Then click the PassZit icon, enter your server's address and choose Connect with the web vault — no password is typed in the extension.
Verify a download
sha256sum -c SHA256SUMS --ignore-missing # programs and packages
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, VHDX zip, ISO
The server and the install script verify the signed release manifest before installing anything; see Security.
Updating
Settings → Updates and server shows the running and the newest version and installs updates, optionally automatically at a chosen hour. Only releases signed with the PassZit release key are installed; the server backs up its database and program first and puts them back if the new version does not start. The Testing channel offers release candidates for a test server. Settings → Console backup keeps encrypted daily backups of the database, the server's secret key and the certificate for a restore on a new machine.