Crumb-Core-v.1/docs/crumbforest/# ☁️ Mattermost Deployment Readme (Crumb.md

☁️ 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:

   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:

platform: linux/amd64

⚠️ SQL-Import schlägt fehl?

Fehlermeldung:

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:

• Mattermost läuft auf Port 8065
• Team & Admin-User eingerichtet
• 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 ✨