knowledge-base/wiki/decisions/2026-04-volume-persistence.md

---
created: 2026-06-16
updated: 2026-06-16
sources: []
tags: [decisions, architecture, infrastructure, docker, persistence]
---

# Entscheidung: Volume-Persistenz nach LanceDB-Havarie

> Datum: 2026-04-06 | Betroffen: Infrastruktur

## Problem

Drei Container-Resets (4.-6. April 2026) durch LanceDB-Installation ohne persistentes Volume → Workspace-Datenverlust.

## Entscheidung

1. **Volume `bot_workspace_2`** dauerhaft mounten auf `/home/node/workspace`
2. Provisioning-Reihenfolge: Volume → `chown -R node:node` → Stateful Plugins installieren
3. Alle persistenten Daten (Config, memory/, `.openclaw/`) müssen auf dem Volume liegen
4. ByteRover `.brv-cli` benötigt separates Volume für OAuth-Tokens (🔴 nie umgesetzt)

## Status

- ✅ Volume funktioniert, Permission-Fix dokumentiert
- ❌ `.brv-cli`-Volume nie deployed → OAuth-Token weiterhin Container-lebensdauer
- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11
## Hintergrund — Warum das passierte

Vor dieser Entscheidung lief der Bot-Container mit einem **ephemeren Filesystem** — kein persistentes Volume, kein Bind-Mount. Drei Probleme häuften sich in der ersten Aprilwoche:

1. **LanceDB-Installation am 2026-04-04** verursachte einen Container-Reset, weil das Datenverzeichnis `~/.lancedb` auf dem Container-Filesystem lag und beim Rebuild verloren ging.
2. **Memory-System (Schicht 3)** baute auf LanceDB auf — Reset bedeutete Totalverlust des Vektor-Index.
3. **OAuth-Tokens** (ByteRover `.brv-cli`, Subconscious-Plugin-Tokens) wurden gleich mitverloren.

Die Entscheidung am 2026-04-06 zog daraus die Konsequenz: **alles, was über Container-Lebensdauer hinaus leben soll, gehört auf ein gemountetes Volume** — nicht "manchmal" oder "für wichtige Daten", sondern ausnahmslos.

## Konsequenzen

Die strikte Volume-Pflicht wurde zur Grundlage für alle späteren Architekturentscheidungen: Memory-System, Wiki-Repository, Plugin-State. Siehe [[wiki/architecture/container-volume-persistence]] für die allgemeinen Lessons Learned und [[wiki/architecture/byterover-knowledge-mining]] für die konkrete Pipeline, die an genau dieser Lücke scheiterte.

## Verwandte Seiten

- [[wiki/architecture/container-volume-persistence]] — ausführliche Lessons-Learned
- [[wiki/architecture/memory-system]] — Memory-Schichten, die alle auf dem Volume liegen
- [[wiki/architecture/byterover-knowledge-mining]] — Pipeline, die an fehlendem `.brv-cli`-Volume starb
lint(wiki): add missing frontmatter to wiki/decisions/2026-04-volume-persistence.md 2026-06-16 11:59:41 +02:00			`---`
			`created: 2026-06-16`
			`updated: 2026-06-16`
			`sources: []`
			`tags: [decisions, architecture, infrastructure, docker, persistence]`
			`---`

feat: migrate ByteRover context-tree (April 2026) into knowledge base wiki 2026-06-07 11:47:41 +02:00			`# Entscheidung: Volume-Persistenz nach LanceDB-Havarie`

			`> Datum: 2026-04-06 \| Betroffen: Infrastruktur`

			`## Problem`

			`Drei Container-Resets (4.-6. April 2026) durch LanceDB-Installation ohne persistentes Volume → Workspace-Datenverlust.`

			`## Entscheidung`

			1. Volume `bot_workspace_2` dauerhaft mounten auf `/home/node/workspace`
			2. Provisioning-Reihenfolge: Volume → `chown -R node:node` → Stateful Plugins installieren
			3. Alle persistenten Daten (Config, memory/, `.openclaw/`) müssen auf dem Volume liegen
			4. ByteRover `.brv-cli` benötigt separates Volume für OAuth-Tokens (🔴 nie umgesetzt)

			`## Status`

			`- ✅ Volume funktioniert, Permission-Fix dokumentiert`
			- ❌ `.brv-cli`-Volume nie deployed → OAuth-Token weiterhin Container-lebensdauer
content(wiki): expand stub 2026-04-volume-persistence.md (+20 lines) 2026-06-16 12:42:24 +02:00			`- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11`
			`## Hintergrund — Warum das passierte`

			`Vor dieser Entscheidung lief der Bot-Container mit einem ephemeren Filesystem — kein persistentes Volume, kein Bind-Mount. Drei Probleme häuften sich in der ersten Aprilwoche:`

			1. LanceDB-Installation am 2026-04-04 verursachte einen Container-Reset, weil das Datenverzeichnis `~/.lancedb` auf dem Container-Filesystem lag und beim Rebuild verloren ging.
			`2. Memory-System (Schicht 3) baute auf LanceDB auf — Reset bedeutete Totalverlust des Vektor-Index.`
			3. OAuth-Tokens (ByteRover `.brv-cli`, Subconscious-Plugin-Tokens) wurden gleich mitverloren.

			`Die Entscheidung am 2026-04-06 zog daraus die Konsequenz: alles, was über Container-Lebensdauer hinaus leben soll, gehört auf ein gemountetes Volume — nicht "manchmal" oder "für wichtige Daten", sondern ausnahmslos.`

			`## Konsequenzen`

			`Die strikte Volume-Pflicht wurde zur Grundlage für alle späteren Architekturentscheidungen: Memory-System, Wiki-Repository, Plugin-State. Siehe [[wiki/architecture/container-volume-persistence]] für die allgemeinen Lessons Learned und [[wiki/architecture/byterover-knowledge-mining]] für die konkrete Pipeline, die an genau dieser Lücke scheiterte.`

			`## Verwandte Seiten`

			`- [[wiki/architecture/container-volume-persistence]] — ausführliche Lessons-Learned`
			`- [[wiki/architecture/memory-system]] — Memory-Schichten, die alle auf dem Volume liegen`
			- [[wiki/architecture/byterover-knowledge-mining]] — Pipeline, die an fehlendem `.brv-cli`-Volume starb