Fehlerbehebung

Die Meldungen der Anwendung sind hier sinngemäß übersetzt; in der englischen Oberfläche lauten sie wie in der englischen Fassung.

Docker Compose

Symptom	Vorgehen
Docker meldet permission denied oder keine Verbindung	Ihr Konto darf Docker nicht verwenden, oder Docker Engine läuft nicht. docker version muss einen Server-Abschnitt zeigen.
Die Einrichtung lehnt ein Platzhalter- oder zu kurzes DB_PASSWORD ab	Erzeugen Sie vor der ersten Einrichtung eines mit dem sed-Befehl aus der Installation. Ändern Sie es danach nie.
Set VAULTIGEN_IMAGE_TAG / VAULTIGEN_DOMAIN / DB_PASSWORD in .env	Führen Sie den Befehl im Verzeichnis mit compose.yaml und .env aus und tragen Sie den Wert ein.
Kein HTTPS-Zertifikat	Prüfen Sie VAULTIGEN_DOMAIN, die DNS-Einträge (auch IPv6) und ob die Ports 80 und 443 aus dem Internet den Server erreichen. Lesen Sie docker compose logs --tail=100 web.
Die Seite öffnet nicht	docker compose ps, dann die Web-Logs. Prüfen Sie, dass nichts anderes die Ports 80 oder 443 belegt; sonst verwenden Sie die Proxy-Ergänzung.
Hinter einem Proxy haben alle Benutzer die IP-Adresse des Proxys, oder Weiterleitungen verwenden http://	Der Proxy muss X-Forwarded-For und X-Forwarded-Proto weiterleiten. Ein Proxy, der nicht auf demselben Host läuft, braucht VAULTIGEN_TRUSTED_PROXIES; rootless Podman braucht 172.31.250.10.
Web, Worker und Scheduler starten nach einem Update nicht	docker compose logs --tail=100 migrate. Beheben Sie das gemeldete Backup-, Schlüssel- oder Migrationsproblem, dann docker compose up -d --wait. Umgehen Sie migrate nicht.
Setup oder migrate meldet fehlende Schlüssel für eine bestehende Installation	Entpacken Sie Ihre Schlüsselkopie nach data/ oder stellen Sie wieder her. Löschen Sie nie Dateien und erzeugen Sie nie neue Schlüssel, um den Fehler zu umgehen.
Eine geänderte .env wirkt nicht	Führen Sie docker compose up -d --wait aus; restart behält die alten Einstellungen.
Permission denied auf data/ oder backups/ vom Host aus	Erwartet: Sie gehören den Container-Benutzern. Lesen Sie sie mit sudo und ändern Sie nie ihre Besitzer.
Speicher voll	df -h. Kopieren Sie alte Sätze vom Server weg und entfernen Sie sie dann aus backups/ oder aktivieren Sie die Aufbewahrung. Ein Backup braucht Platz für einen temporären Snapshot und den fertigen Satz.

Installation und Schlüssel

Symptom	Vorgehen
„Installation security configuration is missing or invalid“	Prüfen Sie, dass vaultigen:initialize gelaufen ist, PHP installation.json lesen kann und Umgebungsvariablen zur ursprünglichen Installation passen. Konfigurations-Cache leeren und Worker neu starten.
„Installation identity already exists“	Die Initialisierung läuft nur einmal. Fahren Sie mit Migration oder Bootstrap fort. Löschen Sie nie die Identitätsdatei, um die Meldung loszuwerden.
„The installation KEK key file is missing or unreadable“	Stellen Sie die hinterlegte kek.json wieder her. Nur auf einer ganz neuen Installation ohne Tresordaten dürfen Sie vaultigen:kek:generate ausführen.
„Vaultigen cannot resolve its installation encryption keys“	Die Oberfläche bleibt gesperrt, bis der KEK-Schlüsselbund verfügbar ist. Stellen Sie ihn wieder her; ersetzen Sie ihn auf einer bestehenden Installation nie.
Vite-Manifest fehlt oder Seiten ohne Styles (manuelle Installation)	Führen Sie im Installationsverzeichnis npm ci && npm run build aus.

Anmeldung und zweite Faktoren

Symptom	Vorgehen
Authenticator-Codes werden abgelehnt	Uhr auf dem Server (NTP) und auf dem Telefon prüfen. Bei erneuter Authentifizierung auf einen neuen Code warten, falls der aktuelle schon benutzt wurde.
Kein E-Mail-Code kommt an	E-Mail-Zustellung im Installationsstatus prüfen, dann Erneut senden. Codes laufen nach vier Minuten ab, und das Senden ist begrenzt.
„Dieses Gerät merken“ fehlt	Ein Admin muss unter Einstellungen → Authentifizierung einen Zeitraum größer null setzen.
Ein Benutzer ist ausgesperrt	Ein Super-Admin nutzt Authentifizierung zurücksetzen. Für den einzigen Admin siehe Authentifizierung.

Benutzer und Plätze

Symptom	Vorgehen
„Benutzerlimit erreicht“	Alle Plätze sind belegt. Eine offene Einladung widerrufen, einen Benutzer deaktivieren oder eine Lizenz installieren. Siehe Lizenzierung.
Eine Einladungs-E-Mail wurde nicht gesendet	Mail-Transport reparieren, dann in der Einladungsliste Erneut senden.

Hintergrundarbeit

Symptom	Vorgehen
Queue oder Scheduler „nicht verifiziert“	Beide Prozesse starten (bei Docker Compose: docker compose up -d --wait, dann docker compose logs worker scheduler prüfen), eine Minute warten, Installationsstatus neu laden.
Ein Backup oder Import bleibt in der Warteschlange	Der Queue-Worker läuft nicht. Starten Sie ihn; wartende Jobs werden automatisch abgearbeitet.
Sicherheitsbenachrichtigungen bleiben ausstehend	E-Mail wird nicht zugestellt. Transport reparieren; der Scheduler versucht es erneut.
Warnung zum freien Speicher	Alte Backup-Sätze vom Host verschieben und das temporäre Verzeichnis von PHP prüfen.

Lizenz

Meldung	Bedeutung
Keine gültige Vaultigen-Lizenz	Der Block ist unvollständig. Fügen Sie ihn erneut ein, einschließlich der BEGIN- und END-Zeilen.
Die Lizenzsignatur ist ungültig	Der Text wurde verändert. Kopieren Sie ihn erneut aus der E-Mail oder Ihrem Konto.
Nicht mit einem Schlüssel signiert, dem diese Version vertraut	Ihre Vaultigen-Version ist älter als die Lizenz. Aktualisieren Sie Vaultigen.
Diese Lizenz erfordert eine neuere Vaultigen-Version	Aktualisieren Sie Vaultigen.
Lizenz gilt nicht für diese Version	Die Version ist nach Ihrem Update-Zeitraum erschienen. Verlängern Sie oder kehren Sie zu einer abgedeckten Version zurück.

Kommen Sie nicht weiter? Schreiben Sie an die Adresse unten auf dieser Seite, mit der genauen Meldung, der Vaultigen-Version und dem, was Sie versucht haben. Senden Sie nie Passwörter, Schlüssel oder Lizenzdateien, die Sie nicht teilen möchten.