docs: add Mac Mini setup checklist

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-14 21:21:10 +02:00 · 2026-01-22 22:51:11 +01:00 · 2026-01-22 22:51:11 +01:00 · f3c1c8e009
commit f3c1c8e009
parent e29f52135d
1 changed files with 180 additions and 0 deletions
--- a/docs/MAC_MINI_SETUP_CHECKLIST.md
+++ b/docs/MAC_MINI_SETUP_CHECKLIST.md
@ -0,0 +1,180 @@
+# Mac Mini Setup Checklist
+
+**Server:** mana-server (ssh.mana.how)
+**Domain:** mana.how
+**Stand:** 22.01.2026
+
+---
+
+## 1. SSH verbinden
+
+```bash
+ssh mana-server
+```
+
+---
+
+## 2. Repo aktualisieren
+
+```bash
+cd ~/projects/manacore-monorepo
+git pull
+```
+
+---
+
+## 3. Environment-Datei erstellen
+
+```bash
+cp .env.macmini.example .env.macmini
+nano .env.macmini
+```
+
+**Diese Werte eintragen:**
+
+```env
+# Datenbank (selbst ausdenken, sicher!)
+POSTGRES_PASSWORD=MeinSicheresPasswort123!
+
+# Redis (selbst ausdenken)
+REDIS_PASSWORD=RedisPasswort456!
+
+# JWT Secret (mind. 32 Zeichen)
+JWT_SECRET=MeinSuperGeheimerJWTSecretKey2026!
+
+# Optional: Azure OpenAI für Chat
+AZURE_OPENAI_ENDPOINT=https://xxx.openai.azure.com/
+AZURE_OPENAI_API_KEY=xxx
+```
+
+Speichern: `Ctrl+O`, `Enter`, `Ctrl+X`
+
+---
+
+## 4. Cloudflared Service einrichten (einmalig)
+
+```bash
+chmod +x scripts/mac-mini/setup-cloudflared-service.sh
+./scripts/mac-mini/setup-cloudflared-service.sh
+```
+
+**Prüfen ob es läuft:**
+```bash
+launchctl list | grep cloudflared
+tail -f /tmp/cloudflared.log
+```
+
+---
+
+## 5. Docker Images pullen & Container starten
+
+```bash
+# Bei GitHub einloggen (PAT mit read:packages Berechtigung)
+echo "DEIN_GITHUB_TOKEN" | docker login ghcr.io -u memo-2023 --password-stdin
+
+# Images pullen
+docker compose -f docker-compose.macmini.yml --env-file .env.macmini pull
+
+# Container starten
+docker compose -f docker-compose.macmini.yml --env-file .env.macmini up -d
+```
+
+---
+
+## 6. Datenbanken erstellen
+
+```bash
+docker compose -f docker-compose.macmini.yml exec -T postgres psql -U postgres -c "CREATE DATABASE manacore_auth;"
+docker compose -f docker-compose.macmini.yml exec -T postgres psql -U postgres -c "CREATE DATABASE chat;"
+docker compose -f docker-compose.macmini.yml exec -T postgres psql -U postgres -c "CREATE DATABASE todo;"
+docker compose -f docker-compose.macmini.yml exec -T postgres psql -U postgres -c "CREATE DATABASE calendar;"
+docker compose -f docker-compose.macmini.yml exec -T postgres psql -U postgres -c "CREATE DATABASE clock;"
+```
+
+---
+
+## 7. Status prüfen
+
+```bash
+# Container Status
+docker compose -f docker-compose.macmini.yml ps
+
+# Logs anschauen (falls Probleme)
+docker compose -f docker-compose.macmini.yml logs -f
+```
+
+---
+
+## 8. Health Checks
+
+```bash
+curl -s http://localhost:3001/api/v1/health && echo " ✓ Auth"
+curl -s http://localhost:5173/health && echo " ✓ Dashboard"
+curl -s http://localhost:3002/api/v1/health && echo " ✓ Chat API"
+curl -s http://localhost:3000/health && echo " ✓ Chat Web"
+curl -s http://localhost:3018/api/health && echo " ✓ Todo API"
+curl -s http://localhost:5188/health && echo " ✓ Todo Web"
+curl -s http://localhost:3016/api/v1/health && echo " ✓ Calendar API"
+curl -s http://localhost:5186/health && echo " ✓ Calendar Web"
+curl -s http://localhost:3017/api/v1/health && echo " ✓ Clock API"
+curl -s http://localhost:5187/health && echo " ✓ Clock Web"
+```
+
+---
+
+## 9. Im Browser testen
+
+| App | URL |
+|-----|-----|
+| Dashboard | https://mana.how |
+| Auth API | https://auth.mana.how/api/v1/health |
+| Chat | https://chat.mana.how |
+| Todo | https://todo.mana.how |
+| Calendar | https://calendar.mana.how |
+| Clock | https://clock.mana.how |
+
+---
+
+## Nützliche Befehle
+
+```bash
+# Alle Container stoppen
+docker compose -f docker-compose.macmini.yml down
+
+# Alle Container neustarten
+docker compose -f docker-compose.macmini.yml restart
+
+# Logs eines Services
+docker compose -f docker-compose.macmini.yml logs -f mana-core-auth
+
+# Update auf neue Images
+docker compose -f docker-compose.macmini.yml pull
+docker compose -f docker-compose.macmini.yml up -d
+
+# Alte Images aufräumen
+docker image prune -f
+
+# Cloudflared Logs
+tail -f /tmp/cloudflared.log
+```
+
+---
+
+## Troubleshooting
+
+**Container startet nicht:**
+```bash
+docker compose -f docker-compose.macmini.yml logs <service-name>
+```
+
+**Datenbank-Fehler:**
+```bash
+docker compose -f docker-compose.macmini.yml exec postgres psql -U postgres -c "\l"
+```
+
+**Cloudflared Probleme:**
+```bash
+launchctl unload ~/Library/LaunchAgents/com.cloudflare.cloudflared.plist
+launchctl load ~/Library/LaunchAgents/com.cloudflare.cloudflared.plist
+tail -f /tmp/cloudflared.error.log
+```