Voraussetzungen

Vaultigen läuft auf einem gewöhnlichen Linux-Server, den Sie kontrollieren. Es braucht keinen externen Schlüsseldienst und keine Verbindung zum Hersteller. Wählen Sie einen von zwei Installationswegen; die Anforderungen unterscheiden sich nur auf dem Host.

Installation mit Docker Compose (empfohlen)

• Ein 64-Bit-x86-Linux-Host (AMD64), virtuelle Maschine oder Hardware. Für die meisten Organisationen reicht eine kleine VM. ARM64 wird noch nicht unterstützt.
• Docker Engine mit dem Docker-Compose-Plugin (2.24.4 oder neuer, wenn Sie die Reverse-Proxy-Ergänzung verwenden).
• Ein Hostname mit DNS-Eintrag für den Server und eingehend die Ports 80 und 443 für automatisches HTTPS, oder ein bestehender Reverse Proxy, der HTTPS terminiert.
• Speicherplatz für Datenbank, Anhänge und Backup-Sätze. Ein Backup braucht gleichzeitig Platz für einen temporären Snapshot und den fertigen Satz; lokales Löschen alter Sätze ist aus, bis Sie es aktivieren.
• Ausgehend Zugang zu Docker Hub (Images), zur Zertifizierungsstelle des automatischen HTTPS (Let’s Encrypt oder ZeroSSL) und zu Ihrem Mailserver.
• Eine genaue Uhr (systemd-timesyncd, chrony oder ein anderer NTP-Client).
• sudo auf dem Host, um den Schlüsselordner und die Backups zu kopieren, die den Container-Benutzern gehören.

Das Image enthält PHP 8.5, alle nötigen Erweiterungen, den Webserver und die Datenbankwerkzeuge. Der Compose-Stack verwendet immer sein mitgeliefertes PostgreSQL 18. Sie installieren kein PHP, Composer, Node.js, keinen Webserver und keine Datenbank auf dem Host.

Manuelle Installation

Server

• Ein Linux-Host (virtuelle Maschine oder Hardware), den Sie kontrollieren. Für die meisten Organisationen reicht eine kleine VM.
• Ein Webserver wie nginx, Apache oder Caddy, der HTTPS terminiert. Vaultigen ist nicht für unverschlüsseltes HTTP im Produktivbetrieb gedacht.
• Ein Prozess-Supervisor (systemd, supervisord o. Ä.) für Queue-Worker und Scheduler.
• Eine genaue Uhr. Betreiben Sie systemd-timesyncd, chrony oder einen anderen NTP-Client: Einmalcodes, Ablaufdaten von Berechtigungen und Audit-Zeitstempel hängen davon ab.

PHP

• PHP 8.5 mit den Erweiterungen, die Laravel benötigt, sowie:
  • sodium (Pflicht; es gibt keine Ausweich-Verschlüsselung),
  • gd mit Unterstützung für JPEG, PNG, GIF und WebP, um hochgeladene Tresorbilder zu verkleinern,
  • pdo_pgsql, pdo_mysql oder pdo_sqlite für Ihre Datenbank.
• Composer 2.
• upload_max_filesize und post_max_size von mindestens 25 MB (das Standardlimit für Anhänge).

Build-Werkzeuge

• Node.js 22.12 oder neuer mit npm, um bei Installation und Updates die Frontend-Assets zu bauen. Zur Laufzeit wird Node.js nicht benötigt.

Datenbank

System	Empfehlung
PostgreSQL	Empfohlen für den Produktivbetrieb. Beste Nebenläufigkeit und der einfachste Betrieb.
MySQL 8.4+ / MariaDB 11.4+	Vollständig unterstützt. Verwenden Sie InnoDB.
SQLite	Unterstützt für kleine Installationen mit einer Anwendungsinstanz und einem Queue-Worker. Die Datei muss auf einer lokalen Festplatte liegen, nie auf einem Netzwerk-Dateisystem.

Backups verwenden die Snapshot-Werkzeuge der Datenbank, installieren Sie sie also auf dem Server: pg_dump und psql für PostgreSQL, mysqldump/mariadb-dump und den mysql-Client für MySQL/MariaDB. SQLite braucht nichts zusätzlich.

E-Mail

Vaultigen versendet Einladungen, E-Mail-Anmeldecodes und Sicherheitsbenachrichtigungen. Konfigurieren Sie einen SMTP-Server oder einen anderen von Laravel unterstützten Mail-Transport. Ohne funktionierende E-Mail können keine Einladungen zugestellt werden, und Sicherheitsbenachrichtigungen bleiben ausstehend.

Netzwerk

• Eingehend: HTTPS von Ihren Benutzern (mit Docker Compose auch HTTP auf Port 80 für die Zertifikatsausstellung und die Weiterleitung).
• Ausgehend: Ihr Mailserver. Der Docker-Weg braucht zusätzlich Docker Hub und die Zertifizierungsstelle, wie oben genannt. Vaultigen kontaktiert nie den Hersteller.
• Optional: Die Funktion Website-Icons lädt das Icon der Website eines Logins direkt von dieser Website. Sie können sie unter Einstellungen abschalten, wenn Ihre Egress-Richtlinie das verbietet.

Browser

Jede aktuelle Version von Firefox, Chrome, Edge oder Safari. Der Passwortgenerator nutzt die Web-Crypto-API des Browsers.