Worum es in dieser Anleitung geht
PassZit ist ein kostenloser Open-Source-Passwortmanager (AGPLv3), der auf Ihrem eigenen Server läuft. Jeder Benutzer hat einen Ende-zu-Ende-verschlüsselten Tresor für Anmeldungen, Einmalcodes, sichere Notizen, Karten, SSH-Schlüssel und Dateien; Teams teilen Tresore mit Rechten pro Person. Der Server speichert nur Chiffretext. Wenn Sie Werkzeuge vergleichen, weil Sie nach einer selbst gehosteten Bitwarden-Alternative gesucht haben, zeigt diese Anleitung, wie Installation und Einführung von PassZit in der Praxis aussehen.
- Was Sie brauchen
- Den Server installieren
- Erste Anmeldung und erster Administrator
- Ein Zertifikat, dem Browser vertrauen
- Das Team einladen
- Master-Passwort und Wiederherstellungsschlüssel
- Die Browsererweiterung installieren
- Passwörter aus einem anderen Programm importieren
- So funktioniert die Verschlüsselung
- Den Server sichern
- Updates
- Grenzen, die Sie kennen sollten
- Nächste Schritte
Was Sie brauchen
- Eine virtuelle Maschine auf VMware, VirtualBox, Proxmox VE/KVM oder Hyper-V oder einen physischen Server mit 2 vCPU, 2 GB RAM und 16 GB Festplatte — oder einen vorhandenen 64-Bit-Server mit Debian 12+, Ubuntu 22.04+, AlmaLinux oder Rocky Linux 9+ (x86-64 oder ARM64).
- Browser erreichen den Server über TCP 8443. PostgreSQL richten das Installationsskript und die Images ein.
- Für die Browsererweiterungen: einen DNS-Namen für den Server und ein Zertifikat, dem die Browser vertrauen (siehe unten).
- Optional einen SMTP-Server, damit PassZit Einladungen und Hinweise per E-Mail senden kann.
Den Server installieren
Es gibt vier Wege; alle stehen auf der Download-Seite, und jedes Release ist signiert.
| Weg | Am besten für |
|---|---|
| VM-Image: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V Generation 1) | Importieren, starten, anmelden — Debian, PostgreSQL und PassZit sind bereit |
| Appliance-ISO | Eine neue VM oder ein physischer Server; die unbeaufsichtigte Installation löscht die erste Festplatte |
| Installationsskript | Ein vorhandener Debian-, Ubuntu-, AlmaLinux- oder Rocky-Linux-Server |
| Pakete (deb, rpm; amd64, arm64) | Eigenes PostgreSQL und Konfigurationsmanagement |
VM-Image oder ISO: Starten Sie die VM. Ihr Bildschirm zeigt die Konsolenadresse und das Einrichtungstoken. An der Konsole der VM melden Sie sich als pzadmin an (erstes Passwort passzit, wird bei der ersten Anmeldung geändert): Ein Menü stellt Netzwerk, Servernamen und Zeitzone ein, zeigt das Einrichtungstoken erneut und stellt Backups wieder her. Nur die Ports 22 (SSH) und 8443 sind offen.
Installationsskript: als root auf dem Server:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Das Skript installiert PostgreSQL, lädt das neueste Release, prüft seine Signatur, legt eine Datenbank mit zufälligem Passwort an, startet den Dienst und gibt Adresse und Einrichtungstoken aus. Optionen wie --version, --db (eine vorhandene PostgreSQL-Datenbank) oder --no-auto-updates werden mit sh -s -- übergeben.
Pakete: Installieren Sie das deb- oder rpm-Paket, setzen Sie PASSZIT_DB in /etc/passzit/server.env und führen Sie systemctl start passzit-server aus. Das Einrichtungstoken steht in /var/lib/passzit/setup-token.txt.
Erste Anmeldung und erster Administrator
- Öffnen Sie
https://<server>:8443. Ein neuer Server nutzt ein selbstsigniertes Zertifikat; der Browser warnt einmal — akzeptieren Sie es. - Geben Sie das Einrichtungstoken, Ihre E-Mail-Adresse und ein Master-Passwort ein. Ihr Browser erzeugt jetzt Ihre Schlüssel; das dauert eine Sekunde. Dieses erste Konto ist der Administrator.
- Scannen Sie den QR-Code mit einer Authenticator-App (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). Die Zwei-Faktor-Anmeldung ist für jedes Konto Pflicht. Bewahren Sie die zehn Wiederherstellungscodes auf; jeder ersetzt die App einmal.
- Erstellen Sie einen Wiederherstellungsschlüssel (siehe unten) und legen Sie mit Neuer Eintrag die erste Anmeldung an.
Später können Sie unter Mein Konto Sicherheitsschlüssel (YubiKey und andere) oder einen Passkey Ihres Geräts als zweiten Faktor hinzufügen.
Ein Zertifikat, dem Browser vertrauen
Die Browsererweiterungen lehnen selbstsignierte Zertifikate ab; geben Sie dem Server also ein echtes, bevor Sie die Erweiterung verteilen. Unter Einstellungen → Zertifikat laden Sie entweder ein Zertifikat hoch (von Ihrer Firmen-CA oder gekauft; PEM mit den Zwischenzertifikaten und dem privaten Schlüssel) oder wählen Let's Encrypt. Let's Encrypt braucht einen öffentlichen DNS-Namen und prüft ihn über Port 80 des Servers oder über einen DNS-Eintrag bei Cloudflare — Letzteres funktioniert auch für einen Server, der nur in Ihrem Netzwerk erreichbar ist. Das Zertifikat gilt sofort, ohne Neustart; das DNS Ihres Netzwerks muss den Namen auf den Server zeigen lassen.
Das Team einladen
Konten entstehen nur per Einladung. Unter Benutzer → Benutzer einladen geben Sie die E-Mail-Adresse und die Rolle ein (Benutzer oder Administrator). PassZit zeigt den Einladungslink einmal an; schicken Sie ihn der Person. Der Link funktioniert einmal und standardmäßig 7 Tage lang. Haben Sie unter Einstellungen → E-Mail einen SMTP-Server eingerichtet, kreuzen Sie Einladung auch per E-Mail senden an, und PassZit verschickt sie für Sie.
Die eingeladene Person wählt ein Master-Passwort und richtet die Zwei-Faktor-Anmeldung ein, wie Sie. Administratoren können Benutzer deaktivieren, einen verlorenen zweiten Faktor zurücksetzen und offene Einladungen zurückziehen. Zum Teilen von Passwörtern legen Sie einen geteilten Tresor an und geben Personen oder Gruppen Zugriff.
Firmenkonten verbinden Sie unter Einstellungen → Firmenanmeldung: Single Sign-on mit OpenID Connect oder SAML 2.0 sowie Active Directory / LDAP. Das Master-Passwort bleibt immer, denn es ist der Schlüssel zum Tresor.
Master-Passwort und Wiederherstellungsschlüssel
Das Master-Passwort verlässt nie den Browser des Benutzers. Das ist der Sinn der Ende-zu-Ende-Verschlüsselung, und es hat eine Folge: Niemand — weder der Administrator noch MaxZit — kann einen Tresor ohne das Master-Passwort oder den Wiederherstellungsschlüssel öffnen. Administratoren können Master-Passwörter weder sehen noch zurücksetzen.
- Eine Passphrase aus vier bis sechs zufälligen Wörtern ist leicht zu merken und schwer zu erraten. Die Tresor-Richtlinie legt eine Mindestlänge fest (standardmäßig 12 Zeichen).
- Unter Mein Konto zeigt Wiederherstellungsschlüssel erstellen einen Schlüssel aus 32 Buchstaben und Ziffern, nur einmal. Drucken Sie ihn aus oder schreiben Sie ihn auf und bewahren Sie ihn offline auf — nicht im Tresor und nicht neben dem Telefon.
- Mit dem Wiederherstellungsschlüssel und einem Code der Authenticator-App setzt ein Benutzer, der sein Master-Passwort vergessen hat, auf der Anmeldeseite ein neues. Ohne Wiederherstellungsschlüssel ist der Tresor verloren; der Administrator kann nur das Konto löschen und die Person mit leerem Tresor neu einladen. Die Benutzerliste zeigt, wer einen Wiederherstellungsschlüssel erstellt hat.
Bitten Sie alle, am ersten Tag einen Wiederherstellungsschlüssel zu erstellen.
Die Browsererweiterung installieren
Die Erweiterung füllt Anmeldungen und Einmalcodes nur auf der Website aus, zu der sie gehören, bietet an, neue und geänderte Anmeldungen zu speichern, füllt Karten und Adressen in Zahlungs- und Versandformulare ein und erzeugt Passwörter. Installieren Sie sie aus dem Store Ihres Browsers, der sie aktuell hält:
- Chrome Web Store — Chrome, Brave, Opera und Vivaldi
- Firefox Add-ons — Firefox 128 oder neuer
- Microsoft Edge Add-ons — Microsoft Edge
Die Links stehen auf der Download-Seite. Der PassZit-Server bietet dasselbe: Browsererweiterungen im Menü des Web-Tresors zeigt Mit einem Klick installieren mit dem Store Ihres Browsers und die Pakete seiner eigenen Version für die manuelle Installation.
- Klicken Sie auf das PassZit-Symbol, geben Sie nur die Adresse Ihres Servers ein (zum Beispiel
https://vault.example.com) und klicken Sie auf Mit dem Web-Tresor verbinden. Erlauben Sie dem Browser, dass PassZit mit diesem Server spricht. Ein Port in der Adresse, etwa:8443, funktioniert in jedem Browser, auch in Firefox. - Der Web-Tresor öffnet sich; melden Sie sich dort an, falls noch nicht geschehen.
- Der Tresor fragt, ob die Erweiterung in diesem Browser verbunden werden soll — klicken Sie auf Verbinden. In der Erweiterung wird weder Passwort noch Code eingetippt.
Web-Tresor und Erweiterung teilen sich eine Entsperrung: Entsperren Sie eines, öffnet sich auch das andere; sperren Sie eines, sperren sich beide.
Passwörter aus einem anderen Programm importieren
Jeder Benutzer importiert in seinen eigenen Tresor. Exportieren Sie zuerst aus dem alten Programm, wählen Sie dann im Tresor Werkzeuge → Importieren und die Datei. PassZit erkennt das Format, zeigt, wie viele Einträge und Ordner es gefunden hat und wie viele schon im Tresor sind, und lässt Sie die Ordner der Datei behalten und Duplikate überspringen.
| Von | Export dort |
|---|---|
| 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 oder .csv, nicht die verschlüsselte Variante |
| KeePass 2 / KeePassXC | KeePass XML (2.x) / CSV oder XML |
| 1Password | File → Export → CSV |
| LastPass | Advanced options → Export (CSV) |
Die Datei wird im Browser gelesen; der Server erhält die Einträge nur verschlüsselt. Übernommen werden Anmeldungen, Notizen, Websites, eigene Felder, Ordner, Favoriten und TOTP-Geheimnisse (aus Bitwarden auch Karten, Identitäten und SSH-Schlüssel). Angehängte Dateien sind nicht Teil dieser Exporte. Löschen Sie die Exportdatei danach — sie enthält die Passwörter unverschlüsselt.
So funktioniert die Verschlüsselung
Der Browser leitet aus dem Master-Passwort mit Argon2id (64 MiB, 3 Durchläufe) einen Master-Schlüssel ab. Daraus entstehen zwei Schlüssel: ein Anmeldeschlüssel, der bei der Anmeldung gesendet wird — der Server speichert nur einen argon2id-Hash davon — und ein Wrap-Schlüssel, der den zufälligen Kontoschlüssel des Benutzers entsperrt. Jeder Eintrag, auch Name, Benutzername, Websites und Notizen, wird mit AES-256-GCM unter dem Schlüssel seines Tresors verschlüsselt; geteilte Tresore haben einen eigenen Schlüssel, der für den X25519-Schlüssel jedes Mitglieds versiegelt wird. Der Server sieht Chiffretext, IDs, Größen und Zeitstempel, nie das Master-Passwort oder einen Schlüssel, den er nutzen könnte. Details auf der Sicherheitsseite und in docs/ARCHITECTURE.md im Repository.
Den Server sichern
Einstellungen → Konsolensicherung schreibt jeden Tag (und auf Wunsch mit Jetzt sichern) ein Backup nach /var/lib/passzit/backups: die Datenbank mit allen Tresoren, den geheimen Schlüssel des Servers und das Konsolenzertifikat — alles, was ein neuer Server braucht. Ein Backup ist immer mit einer Passphrase verschlüsselt, die Sie festlegen; bewahren Sie sie an einem anderen Ort auf. Jedes Backup kann zusätzlich in einen SFTP-Ordner auf einem anderen Server kopiert werden. Zum Wiederherstellen nutzen Sie das Menü der Appliance, oder Sie stoppen den Dienst und führen passzit-server -restore aus, wie im Handbuch in der Konsole beschrieben.
Updates
Einstellungen → Updates und Server zeigt die laufende und die neueste Version. Die Installation prüft die Signatur erneut, sichert Datenbank und Programm, installiert das Update und prüft, ob der Server wieder läuft — wenn nicht, stellt sie die alte Version und die Datenbank selbst wieder her. Dort lässt sich auch die automatische Installation zu einer gewählten Stunde einschalten. Der Kanal Stabil erhält Releases; Testing bietet zusätzlich Release-Kandidaten, für einen Testserver. Bei einer Skript-Installation aktualisiert ein erneuter Aufruf des Installationsskripts PassZit ebenfalls und behält alle Daten.
Grenzen, die Sie kennen sollten
- PassZit wird aktiv entwickelt: Das erste öffentliche Release war 0.9.0 im November 2026, und neue Versionen erscheinen häufig.
- Es gibt keine native Mobil-App. Auf Telefonen lässt sich der Web-Tresor zum Startbildschirm hinzufügen und öffnet sich in einem eigenen Fenster, aber nichts wird offline gespeichert — ohne den Server sehen Sie eine „Offline“-Seite.
- Ein vergessenes Master-Passwort ohne Wiederherstellungsschlüssel kann niemand wiederherstellen.
- Die Browsererweiterungen brauchen ein vertrauenswürdiges Zertifikat und melden sich mit Master-Passwort und Authenticator-Code an — nicht per Single Sign-on.
- Wie bei jedem Web-Tresor kommt dessen JavaScript vom Server; ein vollständig kompromittierter Server könnte also veränderten Code ausliefern. Die Erweiterung bringt ihren eigenen Code mit.
- Es gibt kein Docker-Image; installieren Sie mit einem Image, dem Skript oder den Paketen. Das Handbuch in der Konsole gibt es auf Englisch und Serbisch.
Nächste Schritte
Laden Sie PassZit herunter, sehen Sie sich alle Funktionen an — geteilte Tresore, geheime Links, Notfallzugriff, Fernverbindungen, die Kommandozeile — oder lesen Sie das in die Konsole eingebaute Handbuch (Dokumentation). Wie Sie geteilte Tresore für ein Team einrichten, beschreibt die Anleitung Passwörter im Team teilen. Fragen sind in den GitHub Discussions willkommen. Unternehmen erhalten kommerziellen Support von MaxZit (nur auf Englisch).