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

2.2 KiB

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

PATH=/opt/homebrew/bin:$PATH colima stop

3. Home-Directory Mount in Colima Config einfuegen

sed -i '' '/^mounts:/a\
  - location: /Users/mana\
    writable: true
' ~/.colima/default/colima.yaml

4. Verifizieren dass beide Mounts drin sind

grep -A8 'mounts:' ~/.colima/default/colima.yaml

Erwartete Ausgabe:

mounts:
  - location: /Users/mana
    writable: true
  - location: /Volumes/ManaData
    writable: true

5. Colima starten

PATH=/opt/homebrew/bin:$PATH colima start

6. Testen ob File-Mounts funktionieren

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

cd ~/projects/managarten
docker compose -f docker-compose.macmini.yml up -d --no-build

8. Pruefen ob die vorher crashenden Container laufen

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

./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