Aktualisieren

Ein Update spielt eine neuere getaggte Version auf die bestehende Installation ein. Datenbank, Schlüssel und Dateien bleiben, wo sie sind.

Vor dem Update

1. Lesen Sie den Changelog der Zielversion, insbesondere Hinweise auf nötige Schritte.
2. Prüfen Sie Ihre Lizenz (nur lizenzierte Installationen). Vergleichen Sie unter System → Lizenz Ihr Datum „Updates bis“ mit dem Veröffentlichungsdatum der neuen Version. Ist die neue Version nach dem Ende Ihres Update-Zeitraums erschienen, fällt die Installation bis zur Verlängerung auf die kostenlose Edition zurück. Bestehende Benutzer arbeiten in jedem Fall weiter. Siehe Updates und Verlängerungen.
3. Erstellen Sie ein Backup unter System → Operations und kopieren Sie es vom Host weg. Halten Sie Ihre Schlüsselkopie aktuell.

Docker Compose

Ändern Sie in .env nur die Version:

VAULTIGEN_IMAGE_TAG=1.1.0

Laden Sie dann die neuen Images, stoppen Sie die alten Anwendungsprozesse und starten Sie die neue Version:

cd ~/vaultigen
docker compose pull && docker compose stop web worker scheduler && docker compose up -d --wait

Die Datenbank läuft weiter. Der einmalige Dienst migrate prüft die Installation und ihre Schlüssel, erstellt und prüft ein Backup, wenn Migrationen anstehen, wendet sie einmal an und lässt erst dann Web, Worker und Scheduler starten. Ein fehlgeschlagenes Backup oder eine fehlgeschlagene Migration lässt die Anwendung gestoppt; lesen Sie docker compose logs --tail=100 migrate, beheben Sie die Ursache und führen Sie docker compose up -d --wait erneut aus. Umgehen Sie den Dienst migrate nicht.

Behalten Sie den Stopp-Schritt bei: Die Startreihenfolge allein beendet alte Webanfragen und Queue-Jobs vor der Migration nicht. Lange Importe, Backups und Rotationen laufen zuerst zu Ende, das Stoppen des Workers kann also dauern.

Normalerweise behalten Sie dieselbe compose.yaml. Laden Sie die Datei der neuen Version nur, wenn deren Versionshinweise es verlangen. Updates erzeugen nie Schlüssel und löschen nichts in data/. Die mitgelieferte Datenbank bleibt auf PostgreSQL 18; eine Änderung von VAULTIGEN_IMAGE_TAG aktualisiert sie nie, und ein künftiges Major-Upgrade der Datenbank kommt mit eigener Anleitung. Ändern Sie das Datenbank-Image nicht selbst.

Nach dem Update:

• docker compose ps zeigt database, web, worker und scheduler als gesund.
• Sie können sich anmelden und einen bestehenden Eintrag samt Anhang öffnen.
• System → Installationsstatus ist grün, einschließlich Lizenz.
• Eine Einladung oder Test-E-Mail kommt an.
• docker compose exec web php artisan vaultigen:backup läuft durch.

Zurückrollen mit Docker Compose

Eine Schemaänderung kann verhindern, dass Sie einfach zum vorherigen Image zurückgehen. Rollen Sie zurück, indem Sie das vor dem Update erstellte Backup mit der vorherigen Version wiederherstellen; alles, was seit diesem Backup geändert wurde, geht verloren:

docker compose stop web worker scheduler
nano .env    # VAULTIGEN_IMAGE_TAG auf die vorherige Version zurücksetzen
docker compose run --rm --no-deps setup restore /backups/BACKUP_ID
docker compose up -d --wait

Verwenden Sie den Satz mit Auslöser migration unter System → Operations oder ein Backup, das Sie selbst erstellt haben. Die Wiederherstellung ersetzt jede Tabelle, Tabellen der neueren Version bleiben also nicht zurück. Die Schlüssel in data/keys/ bleiben unverändert.

Manuelle Installation

cd /var/www/vaultigen

php artisan down
git fetch --tags
git checkout v1.1.0   # die neue Version

composer install --no-dev --optimize-autoloader
npm ci
npm run build

php artisan migrate --force
php artisan optimize:clear
php artisan up

sudo systemctl restart vaultigen-queue vaultigen-scheduler

Starten Sie auch PHP-FPM neu, wenn Sie OPcache ohne Zeitstempelprüfung verwenden.

Nach dem Update

• Öffnen Sie System → Installationsstatus und prüfen Sie, dass alles grün ist, auch die Prüfung Lizenz.
• Melden Sie sich als normaler Benutzer an, öffnen Sie einen Tresor und zeigen Sie einen Eintrag an.

Regeln, die immer gelten

• Führen Sie auf einer bestehenden Installation nie key:generate aus. APP_KEY schützt gespeicherte Authentifizierungsdaten.
• Führen Sie vaultigen:initialize nie erneut aus und ersetzen Sie nie installation.json oder kek.json. Bestehende Daten hängen von den ursprünglichen Werten ab.
• Überspringen Sie keine Migrationen. Führen Sie nach jedem Code-Update php artisan migrate --force aus. Bei Docker Compose erledigt das der Dienst migrate.
• Führen Sie bei Docker Compose nie setup aus, um eine bestehende Installation zu reparieren, und löschen oder erzeugen Sie nie etwas in data/keys/.

Eine manuelle Installation zurückrollen

Macht eine Version Probleme, wechseln Sie auf den vorherigen Tag und bauen neu. Hat die neue Version Migrationen ausgeführt, mit denen der alte Code nicht umgehen kann, stellen Sie das vor dem Update erstellte Backup wieder her. Siehe Wiederherstellung.