managarten/docs/FIX_COLIMA_MOUNTS.md
Till JS b1b9bbc269
Some checks are pending
CD Mac Mini / Detect Changes (push) Waiting to run
CD Mac Mini / Deploy (push) Blocked by required conditions
CI / Detect Changes (push) Waiting to run
CI / Validate (push) Waiting to run
CI / Build mana-search (push) Blocked by required conditions
CI / Build mana-sync (push) Blocked by required conditions
CI / Build mana-api-gateway (push) Blocked by required conditions
CI / Build mana-crawler (push) Blocked by required conditions
Docker Validate / Validate Dockerfiles (push) Waiting to run
Docker Validate / Build calendar-web (push) Blocked by required conditions
Docker Validate / Build quotes-web (push) Blocked by required conditions
Docker Validate / Build todo-backend (push) Blocked by required conditions
Docker Validate / Build todo-web (push) Blocked by required conditions
Docker Validate / Build mana-auth (push) Blocked by required conditions
Docker Validate / Build mana-sync (push) Blocked by required conditions
Docker Validate / Build mana-media (push) Blocked by required conditions
Mirror to Forgejo / Push to Forgejo (push) Waiting to run
chore: rename repo mana-monorepo → managarten
Phase-3-Rename des ehemaligen Multi-App-Monorepos zum eigenständigen
Produkt-Repo. Verein heißt mana e.V., Plattform-Domain bleibt mana.how,
apps/mana/ bleibt unverändert — nur der Repo-Container kriegt den
neuen Namen "managarten" (Garten der mana-Apps).

Geändert:
- package.json#name + #description
- README.md (Titel + erster Absatz)
- TROUBLESHOOTING.md
- alle Mac-Mini-Skripte (Pfade ~/projects/mana-monorepo → ~/projects/managarten)
- COMPOSE_PROJECT_NAME-default in scripts/mac-mini/status.sh
- .github/workflows/cd-macmini.yml + mirror-to-forgejo.yml
- apps/docs (astro.config.mjs + content)
- .claude/settings.local.json (Bash-Permission-Pfade)
- alle docs/*.md Pfad-Referenzen
- launchd plists, .env.macmini.example, infrastructure/

Forgejo-Repo + GitHub-Repo bereits via API umbenannt. Lokales
Verzeichnis-Rename + Mac-Mini-Cutover folgen separat.
2026-05-09 01:16:02 +02:00

91 lines
2.2 KiB
Markdown

# Fix: Colima VirtioFS Mounts nach Stromausfall
Nach dem `colima delete` + recreate fehlt der Home-Directory Mount.
Dadurch werden alle Bind-Mounts zu Projekt-Dateien als leere Verzeichnisse gemountet
und Container wie Synapse, SearXNG, Alertmanager, VictoriaMetrics, Loki crashen.
## Schritte (direkt am Mac Mini ausfuehren)
### 1. Mac Mini neu starten (Power-Button)
SSH funktioniert nicht mehr — der Server muss physisch neugestartet werden.
### 2. Terminal oeffnen und Colima stoppen
```bash
PATH=/opt/homebrew/bin:$PATH colima stop
```
### 3. Home-Directory Mount in Colima Config einfuegen
```bash
sed -i '' '/^mounts:/a\
- location: /Users/mana\
writable: true
' ~/.colima/default/colima.yaml
```
### 4. Verifizieren dass beide Mounts drin sind
```bash
grep -A8 'mounts:' ~/.colima/default/colima.yaml
```
Erwartete Ausgabe:
```
mounts:
- location: /Users/mana
writable: true
- location: /Volumes/ManaData
writable: true
```
### 5. Colima starten
```bash
PATH=/opt/homebrew/bin:$PATH colima start
```
### 6. Testen ob File-Mounts funktionieren
```bash
docker run --rm -v ~/projects/managarten/docker/alertmanager/alertmanager.yml:/test.yml:ro alpine head -3 /test.yml
```
Sollte YAML-Inhalt zeigen, NICHT "Is a directory".
### 7. Alle Container starten
```bash
cd ~/projects/managarten
docker compose -f docker-compose.macmini.yml up -d --no-build
```
### 8. Pruefen ob die vorher crashenden Container laufen
```bash
docker ps --format 'table {{.Names}}\t{{.Status}}' | grep -E 'synapse|searxng|alertmanager|vmalert|victoria|loki'
```
Alle sollten "Up" und "healthy" zeigen.
### 9. Memory Baseline messen
```bash
./scripts/mac-mini/memory-baseline.sh
```
## Ursache
`colima delete` hat die VM komplett geloescht. Beim Neuerstellen mit
`colima start --mount /Volumes/ManaData:w` wurde nur das externe SSD
gemountet, nicht das Home-Directory `/Users/mana`. Ohne diesen Mount
sieht VirtioFS alle Host-Dateien als leere Verzeichnisse.
## Root Cause Fix (2026-03-30)
Das `startup.sh` Script wurde gefixt:
- `colima delete --force` entfernt (loeschte Mount-Config bei jedem Hard-Shutdown-Recovery)
- `--mount /Users/mana:w` wird jetzt immer bei `colima start` mitgegeben
- Damit tritt das Problem bei kuenftigen Neustarts nicht mehr auf