Doku: Erster Start des Gegenbuchs als Drei-Schritt-Ablauf

Die Genesis-Bestaetigung stand nur als Nebensatz in der Anleitung. Jetzt als
eigener Abschnitt mit den drei Schritten (freigeben, starten, wieder leeren),
der erwarteten Ausgabe und der Begruendung, warum das Leeren wichtig ist:
Bleibt die Zeile gesetzt, wuerde nach einem Verlust des Datenverzeichnisses
stillschweigend eine neue Grundlage gesetzt statt nachgefragt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-22 19:58:30 +02:00
co-authored by Claude Opus 5
parent 601fb03b22
commit 1f53a3304b
+29
View File
@@ -49,6 +49,35 @@ cp .env.example .env
docker compose up -d docker compose up -d
``` ```
### Erster Start drei Schritte
Beim allerersten Lauf meldet der Container `exit=4` und verlangt eine
Bestätigung. Das ist Absicht: Der erste Eintrag legt fest, was als
Ausgangszustand gilt.
```bash
# 1. In der .env freigeben
STAGING_GENESIS_ACK=true
# 2. Neu starten (kein --build nötig, nur die Umgebung ändert sich)
docker compose up -d && docker compose logs -f
# Erwartet: "OK: Checkpoint 1 erstellt" und exit=3
# exit=3 ist hier richtig beim ersten Mal gibt es nichts zu vergleichen.
# 3. Wieder leeren und erneut starten
STAGING_GENESIS_ACK=
docker compose up -d
```
Ab dem nächsten Durchlauf steht dort `exit=0 (in Ordnung)`.
**Warum Schritt 3 wichtig ist:** Bleibt die Zeile auf `true`, würde der
Container nach einem Verlust des Datenverzeichnisses stillschweigend eine neue
Grundlage setzen, statt zu fragen genau davor schützt die Abfrage.
Für Produktion später dasselbe mit `PROD_GENESIS_ACK`. Schnell nachsehen ohne
Logs: `cat data/staging/status.txt`.
Beim ersten Start einmalig `PROD_GENESIS_ACK=true` setzen (und danach wieder Beim ersten Start einmalig `PROD_GENESIS_ACK=true` setzen (und danach wieder
leeren) die erste Eintragung legt fest, was als Ausgangszustand gilt, und das leeren) die erste Eintragung legt fest, was als Ausgangszustand gilt, und das
soll nicht versehentlich passieren. soll nicht versehentlich passieren.