PassZit

Download PassZit

Every link points to the newest release on GitHub. Releases are signed; the server updates itself from the same releases.

Choose how to install the server

WayBest forNeeds
1. Ready-made VM imageImport, start, sign in — Debian, PostgreSQL and PassZit readyVMware, VirtualBox, Proxmox/KVM or Hyper-V
2. Appliance ISOA new VM or a physical server, unattendedInternet access during installation
3. Install scriptAn existing Debian, Ubuntu, AlmaLinux or Rocky Linux serverRoot and internet access
4. Packages by handYour own PostgreSQL, configuration managementThe 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

OVA

VMware ESXi, Workstation, VirtualBox

passzit-appliance.ova

ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.

QC

Proxmox VE and KVM

passzit-appliance.qcow2

Create a VM without a disk (2 vCPU, 2 GB RAM, VirtIO network), import the disk, attach it as SCSI boot disk.

VHD

Hyper-V (generation 1)

passzit-appliance-vhdx.zip

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:

FileWhat
passzit-server_X_amd64.deb, _arm64.deb, .rpmThe server, for installation by hand (x86-64 and ARM64)
passzit-extension-chromium-X.zip, -firefox-X.zipThe 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, -arm64Opens remote connections from the extension on Linux; on Windows the MaxZit Launcher does it (download it from your server's Launcher page)
SHA256SUMSChecksums of the programs and packages
SHA256SUMS-applianceChecksums 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:

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.