till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-14 16:41:08 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 5

chore: tidy root files + reorganize a few stale docs

Browse source 
Root file cleanup:
- mac-mini-setup.sh → scripts/mac-mini/bootstrap.sh  (first-time bootstrap
  belongs next to the other mac-mini setup-* scripts)
- test-chat-auth.sh → scripts/test-chat-auth.sh  (ad-hoc smoke test, no
  reason to live in the repo root)
- cloudflared-config.yml stays in root on purpose — it's the single source
  of truth read by scripts/mac-mini/setup-*.sh and scripts/check-status.sh.

Docs:
- docs/POSTMORTEM_2026-04-07.md → docs/postmortems/2026-04-07-memoro-deploy-prod-wipe.md
  (creates the postmortems/ home for future entries; descriptive name)
- docs/future/MAIL_SERVER_MAC_MINI_TEMP.md deleted — what it described
  ("Bereit zur Umsetzung", Stalwart on Mac Mini) is what's actually
  running today, documented in docs/MAIL_SERVER.md. The DEDICATED variant
  in docs/future/ remains since it's still a real future plan.

Root CLAUDE.md fix:
- @mana/local-store description was wrong — claimed it was legacy/standalone
  only, but it's still used by apps/mana/apps/web itself, plus manavoxel,
  arcade, and three shared packages.

Not touched (flagged for follow-up):
- NewAppIdeas/ (344K of "Roblox Reimagined" planning notes in repo root) —
  user decision: archive externally or move under docs/future/
- Doc giants (PROJECT_OVERVIEW 41k, MATRIX_BOT_ARCHITECTURE 36k, etc.) —
  splitting them is its own refactor
- Service CLAUDE.md staleness audit across 18 services — too broad for
  this pass
This commit is contained in:
Till JS 2026-04-08 12:15:27 +02:00
parent c8ed58b7d1
commit 5581295b12
5 changed files with 1 additions and 557 deletions
Download patch file Download diff file Expand all files Collapse all files

2
CLAUDE.md
View file

@ -144,7 +144,7 @@ MinIO (Docker, S3-compatible) in both local and prod. Console: http://localhost:
| `@mana/shared-ui` | React Native UI components |
| `@mana/shared-theme` | Theme config |
| `@mana/shared-i18n` | i18n |
| `@mana/local-store` | Legacy local-first store (standalone apps only — unified Mana uses its own) |
| `@mana/local-store` | Local-first store primitives — used by unified Mana, manavoxel, arcade, and shared-uload/-stores/-links |
## Adding Dependencies

556
docs/future/MAIL_SERVER_MAC_MINI_TEMP.md
View file

@ -1,556 +0,0 @@
# Mail-Server auf Mac Mini (Temporäre Lösung)
> **Status:** Bereit zur Umsetzung
> **Priorität:** Hoch
> **Dauer:** ~2 Stunden
## Übersicht
Temporäre Mail-Server-Installation auf dem Mac Mini bis ein dediziertes Gerät verfügbar ist.
### Vorteile
- Sofort nutzbar
- Keine zusätzliche Hardware nötig
- Eigene Email-Adressen (@mana.how)
### Nachteile
- Alle Dienste auf einem Gerät (Single Point of Failure)
- Mehr Last auf Mac Mini
- Bei Wartung sind Apps UND Email offline
## Voraussetzungen
### Aktuelle Mac Mini Auslastung
| Ressource | Aktuell | Nach Mail-Server | Verfügbar |
|-----------|---------|------------------|-----------|
| RAM | ~400 MB | ~2.5 GB | 16 GB ✅ |
| CPU | ~10% | ~15% | 10 Cores ✅ |
| Disk | 11 GB | ~15 GB | 228 GB ✅ |
→ **Genug Ressourcen vorhanden!**
### Netzwerk-Voraussetzungen
- [ ] Statische öffentliche IP oder DynDNS
- [ ] Zugang zum Router für Port-Forwarding
- [ ] Ports 25, 465, 587, 993 nicht vom ISP blockiert
### Port-Check
```bash
# Prüfen ob Port 25 erreichbar ist (von extern)
# Auf einem anderen Rechner/Server:
telnet <deine-öffentliche-ip> 25
# Oder online: https://www.yougetsignal.com/tools/open-ports/
```
**Wichtig:** Viele ISPs blockieren Port 25 ausgehend. Das betrifft aber nur das Senden AN andere Server, nicht das Empfangen.
## Installations-Plan
### Phase 1: Vorbereitung (15 min)
#### 1.1 DNS-Records anlegen
Bei Cloudflare für `mana.how`:
```
# A-Record für Mail-Server (OHNE Proxy!)
Type: A
Name: mail
Content: <Mac-Mini-Public-IP>
Proxy: DNS only (grey cloud)
# MX-Record
Type: MX
Name: @
Content: mail.mana.how
Priority: 10
# SPF-Record
Type: TXT
Name: @
Content: v=spf1 mx a:mail.mana.how ~all
# DMARC-Record
Type: TXT
Name: _dmarc
Content: v=DMARC1; p=none; rua=mailto:till@mana.how
```
#### 1.2 Router Port-Forwarding
Im Router konfigurieren:
| Externer Port | Interner Port | Ziel | Protokoll |
|---------------|---------------|------|-----------|
| 25 | 25 | Mac-Mini-IP | TCP |
| 465 | 465 | Mac-Mini-IP | TCP |
| 587 | 587 | Mac-Mini-IP | TCP |
| 993 | 993 | Mac-Mini-IP | TCP |
#### 1.3 Cloudflare Tunnel erweitern
Alternativ zu Port-Forwarding: Cloudflare Tunnel für Webmail (Port 443 ist bereits getunnelt).
SMTP-Ports (25, 465, 587, 993) können NICHT über Cloudflare Tunnel laufen → Port-Forwarding nötig.
### Phase 2: Mailcow Installation (45 min)
#### 2.1 Docker Compose erweitern
Neue Datei `docker-compose.mail.yml`:
```yaml
# Mail-Server Stack für Mac Mini
# Basiert auf Mailcow-Dockerized (vereinfacht)
version: '3.8'
services:
# ===========================================
# Database
# ===========================================
mysql-mailcow:
image: mariadb:10.11
container_name: mailcow-mysql
restart: unless-stopped
volumes:
- mysql-vol:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: ${DBROOT}
MYSQL_DATABASE: mailcow
MYSQL_USER: mailcow
MYSQL_PASSWORD: ${DBPASS}
networks:
- mailcow-network
# ===========================================
# Redis
# ===========================================
redis-mailcow:
image: redis:7-alpine
container_name: mailcow-redis
restart: unless-stopped
volumes:
- redis-vol:/data
networks:
- mailcow-network
# ===========================================
# Postfix (SMTP)
# ===========================================
postfix-mailcow:
image: mailcow/postfix:latest
container_name: mailcow-postfix
restart: unless-stopped
depends_on:
- mysql-mailcow
ports:
- "25:25"
- "465:465"
- "587:587"
volumes:
- postfix-vol:/var/spool/postfix
- crypt-vol:/var/lib/zeyple
- rspamd-vol:/var/lib/rspamd
environment:
- DBNAME=mailcow
- DBUSER=mailcow
- DBPASS=${DBPASS}
networks:
- mailcow-network
# ===========================================
# Dovecot (IMAP)
# ===========================================
dovecot-mailcow:
image: mailcow/dovecot:latest
container_name: mailcow-dovecot
restart: unless-stopped
depends_on:
- mysql-mailcow
ports:
- "993:993"
- "995:995"
volumes:
- vmail-vol:/var/vmail
- crypt-vol:/mail_crypt
environment:
- DBNAME=mailcow
- DBUSER=mailcow
- DBPASS=${DBPASS}
networks:
- mailcow-network
# ===========================================
# Rspamd (Spam Filter)
# ===========================================
rspamd-mailcow:
image: mailcow/rspamd:latest
container_name: mailcow-rspamd
restart: unless-stopped
volumes:
- rspamd-vol:/var/lib/rspamd
networks:
- mailcow-network
# ===========================================
# SOGo (Webmail)
# ===========================================
sogo-mailcow:
image: mailcow/sogo:latest
container_name: mailcow-sogo
restart: unless-stopped
depends_on:
- mysql-mailcow
environment:
- DBNAME=mailcow
- DBUSER=mailcow
- DBPASS=${DBPASS}
networks:
- mailcow-network
# ===========================================
# Nginx (Webmail Frontend)
# ===========================================
nginx-mailcow:
image: nginx:alpine
container_name: mailcow-nginx
restart: unless-stopped
ports:
- "8443:443"
depends_on:
- sogo-mailcow
networks:
- mailcow-network
networks:
mailcow-network:
driver: bridge
volumes:
mysql-vol:
redis-vol:
postfix-vol:
vmail-vol:
crypt-vol:
rspamd-vol:
```
#### 2.2 Einfachere Alternative: Vollständiges Mailcow
```bash
# Auf Mac Mini
ssh mana-server
# Mailcow in separatem Verzeichnis
cd ~
git clone https://github.com/mailcow/mailcow-dockerized
cd mailcow-dockerized
# Konfiguration generieren
./generate_config.sh
# Hostname: mail.mana.how
# Timezone: Europe/Berlin
# Ports anpassen (falls Konflikte)
# In mailcow.conf:
# HTTP_PORT=8080
# HTTPS_PORT=8443
# Starten
docker compose pull
docker compose up -d
```
### Phase 3: Konfiguration (30 min)
#### 3.1 Admin-Zugang
```
URL: https://mail.mana.how:8443 (oder via Tunnel)
User: admin
Password: moohoo (SOFORT ÄNDERN!)
```
#### 3.2 Domain hinzufügen
1. Configuration → Mail Setup → Domains
2. Add domain: `mana.how`
3. DKIM-Key kopieren → in Cloudflare DNS eintragen
#### 3.3 Postfächer erstellen
| Adresse | Quota | Verwendung |
|---------|-------|------------|
| till@mana.how | 5 GB | Haupt-Postfach |
| alerts@mana.how | 1 GB | Server-Alerts |
| noreply@mana.how | 500 MB | Automatische Emails |
#### 3.4 Aliases erstellen
| Alias | Ziel |
|-------|------|
| support@mana.how | till@mana.how |
| info@mana.how | till@mana.how |
| admin@mana.how | till@mana.how |
### Phase 4: Cloudflare Tunnel erweitern (15 min)
#### 4.1 Webmail über Tunnel
In `~/.cloudflared/config.yml` hinzufügen:
```yaml
ingress:
# ... bestehende Einträge ...
- hostname: mail.mana.how
service: https://localhost:8443
originRequest:
noTLSVerify: true
- service: http_status:404
```
#### 4.2 Tunnel neustarten
```bash
launchctl stop com.cloudflare.cloudflared
launchctl start com.cloudflare.cloudflared
```
### Phase 5: Mac Mini Alerts umstellen (15 min)
#### 5.1 msmtp Konfiguration
```bash
# ~/.msmtprc aktualisieren
cat > ~/.msmtprc << 'EOF'
defaults
auth on
tls on
tls_starttls on
logfile ~/.msmtp.log
# Eigener Mail-Server
account mana
host localhost
port 587
from alerts@mana.how
user alerts@mana.how
password <alerts-password>
# Gmail als Fallback
account gmail
host smtp.gmail.com
port 587
from tills95@gmail.com
user tills95@gmail.com
password oeyabfavixcaqzvr
account default : mana
EOF
chmod 600 ~/.msmtprc
```
#### 5.2 .env.notifications aktualisieren
```bash
# Telegram (unverändert)
TELEGRAM_BOT_TOKEN=8531397113:AAHmvzpQoWfnSGJo2-vaHuDNrpJSMOjs-AU
TELEGRAM_CHAT_ID=7117174865
# Email (neuer Server)
EMAIL_TO=till@mana.how
EMAIL_FROM=alerts@mana.how
```
### Phase 6: Testing (30 min)
#### 6.1 Senden testen
```bash
# Von Mac Mini
echo "Test vom Mac Mini" | msmtp -a mana till@mana.how
# Von extern
# Email an till@mana.how senden
```
#### 6.2 Empfangen testen
```bash
# Webmail öffnen
open https://mail.mana.how
# Oder IMAP-Client konfigurieren
# Server: mail.mana.how
# Port: 993 (IMAPS)
# User: till@mana.how
```
#### 6.3 Spam-Score testen
1. Gehe zu https://www.mail-tester.com
2. Sende Email an die angezeigte Adresse
3. Ziel: Score ≥ 8/10
#### 6.4 Health Check testen
```bash
# Manuell Fehler simulieren
docker stop mana-chat-backend
# Health Check ausführen
./scripts/mac-mini/health-check.sh
# Prüfen ob Alert ankommt (Telegram + Email)
# Container wieder starten
docker start mana-chat-backend
```
## Ressourcen-Monitoring
### Nach Installation prüfen
```bash
# Docker Stats
docker stats --no-stream
# Erwartete Werte für Mailcow:
# mysql-mailcow: ~200-400 MB RAM
# dovecot-mailcow: ~100-200 MB RAM
# postfix-mailcow: ~50-100 MB RAM
# rspamd-mailcow: ~200-400 MB RAM
# sogo-mailcow: ~200-300 MB RAM
# redis-mailcow: ~50 MB RAM
# nginx-mailcow: ~20 MB RAM
# ---------------------------------
# Gesamt: ~1-2 GB RAM
```
## Skripte
### Mail-Server starten
```bash
#!/bin/bash
# scripts/mac-mini/start-mail.sh
cd ~/mailcow-dockerized
docker compose up -d
```
### Mail-Server stoppen
```bash
#!/bin/bash
# scripts/mac-mini/stop-mail.sh
cd ~/mailcow-dockerized
docker compose down
```
### Mail-Server Status
```bash
#!/bin/bash
# scripts/mac-mini/mail-status.sh
cd ~/mailcow-dockerized
docker compose ps
echo ""
echo "=== Queue ==="
docker compose exec postfix-mailcow postqueue -p
```
## Backup
### Mailcow Backup
```bash
# Backup erstellen
cd ~/mailcow-dockerized
./helper-scripts/backup_and_restore.sh backup all
# Backup-Verzeichnis: ~/mailcow-dockerized/backup/
```
### Automatisches Backup (cron)
```bash
# Täglich um 3 Uhr
0 3 * * * cd ~/mailcow-dockerized && ./helper-scripts/backup_and_restore.sh backup all
```
## Migration zu dediziertem Server
Wenn später ein separates Gerät verfügbar ist:
1. Mailcow auf neuem Gerät installieren
2. Backup vom Mac Mini erstellen
3. Backup auf neuem Gerät wiederherstellen
4. DNS-Records auf neue IP ändern
5. Mac Mini Mail-Container stoppen
6. msmtp auf neuen Server umstellen
## Checkliste
### Vorbereitung
- [ ] Öffentliche IP oder DynDNS eingerichtet
- [ ] Port 25 nicht vom ISP blockiert (testen!)
- [ ] Router-Zugang für Port-Forwarding
### DNS (Cloudflare)
- [ ] A-Record: mail.mana.how → IP (ohne Proxy)
- [ ] MX-Record: mana.how → mail.mana.how
- [ ] SPF-Record hinzugefügt
- [ ] DMARC-Record hinzugefügt
### Router
- [ ] Port 25 → Mac Mini
- [ ] Port 465 → Mac Mini
- [ ] Port 587 → Mac Mini
- [ ] Port 993 → Mac Mini
### Mailcow
- [ ] Installiert und gestartet
- [ ] Admin-Passwort geändert
- [ ] Domain hinzugefügt
- [ ] DKIM-Key in DNS eingetragen
- [ ] Postfächer erstellt
### Cloudflare Tunnel
- [ ] mail.mana.how hinzugefügt
- [ ] Tunnel neugestartet
- [ ] Webmail erreichbar
### Testing
- [ ] Email senden funktioniert
- [ ] Email empfangen funktioniert
- [ ] Webmail funktioniert
- [ ] IMAP funktioniert
- [ ] Spam-Score ≥ 8/10
- [ ] Health Check Alert kommt an
### Alerts
- [ ] msmtp auf eigenen Server umgestellt
- [ ] .env.notifications aktualisiert
- [ ] Test-Alert erfolgreich
## Zeitschätzung
| Phase | Dauer |
|-------|-------|
| DNS + Router | 30 min |
| Mailcow Installation | 45 min |
| Konfiguration | 30 min |
| Cloudflare Tunnel | 15 min |
| Testing | 30 min |
| **Gesamt** | **~2.5 Stunden** |

0
docs/POSTMORTEM_2026-04-07.md → docs/postmortems/2026-04-07-memoro-deploy-prod-wipe.md
View file

0
mac-mini-setup.sh → scripts/mac-mini/bootstrap.sh
View file

0
test-chat-auth.sh → scripts/test-chat-auth.sh
View file