# ☁️ 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 ✨
