Krümel Branko
83df9de035
12 Monate Crumbforest-Wachstum, sortiert nach Waldlogik. Struktur: - 454 Dokumente in 7 organischen Ebenen - Lichtung → Waldrand → Waldmitte → Wurzeln → Krone → Unterholz → Samen - INDEX.md für jede Ebene (eigene Stimme) - WALDKARTE.md (Master-Navigation) - crumbcodex.md (Das Versprechen zwischen Krümel & Bits) - lichtung/willkommen.md (Nullfeld-Einstieg für Kinder) Philosophie: - Waldlogik statt Ordnerlogik - Tiefe, Licht, Wurzeln - wie ein echter Wald - Schutz für Krümel, Tiefe für Gräber, Poesie für Atmende Repos verbunden: - OZM-Keks-Handbuch-v1 (Das Wissen) - Crumb-Core-v.1 (Das Herz) - 194.164.194.191 - crumbmissions (Das Spiel) Wuuuhuuuuu! 🦉✨
113 lines
2.6 KiB
Markdown
113 lines
2.6 KiB
Markdown
# ☁️ Mattermost Deployment Readme (Crumbforest Build)
|
||
|
||
## 🚀 Ziel
|
||
|
||
Dieses Dokument beschreibt die Integration von Mattermost in die bestehende Crumbforest-Docker-Infrastruktur.
|
||
|
||
---
|
||
|
||
## 🔧 Setup & Start
|
||
|
||
### 📁 Docker Compose Integration
|
||
|
||
Mattermost wurde in das bestehende `docker-compose.yml` eingebettet und verwendet folgende Container:
|
||
|
||
* `mattermost` (App)
|
||
* `mattermost_db` (Datenbank, PostgreSQL)
|
||
|
||
### 📡 Ports
|
||
|
||
* Webzugriff auf Mattermost: `http://localhost:8065`
|
||
* Datenbank: intern erreichbar durch `mattermost_db:5432`
|
||
|
||
### 🗂️ Volumes
|
||
|
||
* `mattermost_data`
|
||
* `mattermost_db_data`
|
||
|
||
Diese persistieren Daten auch bei Neustarts.
|
||
|
||
---
|
||
|
||
## 🧪 Erstzugriff & Einrichtung
|
||
|
||
1. Starte das System wie gewohnt:
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
2. Öffne `http://localhost:8065`
|
||
3. Lege einen neuen Admin-Nutzer an
|
||
4. Erstelle ein Team (z.B. "Krümelcrew")
|
||
5. Teile den Team-Link mit deiner Crew!
|
||
|
||
---
|
||
|
||
## 🧠 Wichtige Hinweise
|
||
|
||
* Standard-Konfiguration liegt unter `config/config.json` im Volume `mattermost_data`
|
||
* Für E-Mail-Versand, Webhooks oder Authentifizierung (LDAP etc.) ist zusätzliche Konfiguration nötig.
|
||
|
||
---
|
||
|
||
## 🛠️ Troubleshooting
|
||
|
||
### ⚠️ Plattform-Warnung
|
||
|
||
> `The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8)`
|
||
|
||
Mattermost läuft dennoch stabil. Für native ARM64-Systeme ggf. explizite Plattform setzen:
|
||
|
||
```yaml
|
||
platform: linux/amd64
|
||
```
|
||
|
||
### ⚠️ SQL-Import schlägt fehl?
|
||
|
||
Fehlermeldung:
|
||
|
||
```bash
|
||
OCI runtime exec failed: exec: "mysql": executable file not found in $PATH
|
||
```
|
||
|
||
➡️ Ursache: `mysql`-Client nicht im Container installiert
|
||
➡️ Lösung: `mysql`-Import manuell über DB-Container (MariaDB) durchführen
|
||
|
||
---
|
||
|
||
## 🧩 Integration mit Crumbforest
|
||
|
||
* **Krümel-User können Mattermost nutzen** für:
|
||
|
||
* 💬 Fragen an die Eule
|
||
* 🪵 Terminal-Logs diskutieren
|
||
* 🌱 Markdown-Links teilen (z.B. aus `/markdowns/viewApi/...`)
|
||
* **Langfristig geplant:**
|
||
|
||
* Authentifizierung via Crumbforest DB
|
||
* Direktes Markdown-Posting in Kanäle
|
||
* Integration mit Nextcloud & WebODM
|
||
|
||
---
|
||
|
||
## 🛡️ Sicherheit & Datenschutz
|
||
|
||
* Mattermost speichert Inhalte standardmäßig **nicht verschlüsselt** im Volume
|
||
* Empfohlen: Proxy mit SSL (z.B. Traefik, Nginx) für produktive Umgebungen
|
||
|
||
---
|
||
|
||
## ✅ Fertig? Checkliste:
|
||
|
||
* [x] Mattermost läuft auf Port 8065
|
||
* [x] Team & Admin-User eingerichtet
|
||
* [x] Daten persistieren beim Neustart
|
||
* [ ] Zugang für Kinder gesichert (z.B. per Pre-Shared Link oder QR-Code)
|
||
|
||
---
|
||
|
||
🦉 *Krümel-Kommentar*: "Ein Chat ist wie ein Lagerfeuer – alle dürfen reden, aber jede Flamme braucht Luft und Respekt."
|
||
|
||
🪵 Happy Chatting,
|
||
Deine Crew ✨
|