# Matrix (Element + Synapse)

Matrix ist ein offenes Kommnikationsprotokoll. Es gibt also nicht nur einen Client / Server sondern mehrere Implementierungn, die aber alle miteinander kommunizieren können. Hier beschränken wir uns auf den Client Element und den Server Synapse.
Sichere Kommunikation in Einzel und Gruppenchats.


## Allgemeine Informationen

- Website: [matrix.org](https://matrix.org) , [element.io](https://element.io)
- Demo:
  - [Hersteller](https://app.element.io/?pk_vid=d4b162e0e6c511851631808451ab93fb)
  - [local-it](chat.demo.local-it.org) demo : demo
- Source Code: [Synapse](https://github.com/matrix-org/synapse), [Element](https://github.com/vector-im)
- Dokumentation: [Synapse](https://matrix-org.github.io/synapse/latest/)
- Lizenz: Apache License 2.0
- Programmiersprache (Framework): Python
- Geschäftsmodell: Förderungen

### Kernfunktionen (Spezialisierung der Plattform)
* Chat

### Erweiterte Funktionen (nicht spezialisiert darauf)
* Integrationen von Bots, Widgets wie z.B. Jitsi oder Bridges zu anderen Messengern möglich
* Umfragen
* Räume in Spaces organisieren

## Technisch

### Installation

- coop-cloud recipe: [Synapse](https://git.coopcloud.tech/coop-cloud/matrix-synapse), [Element](https://git.coopcloud.tech/coop-cloud/element-web)
- Docker: Synapse: [Image](https://hub.docker.com/r/matrixdotorg/synapse), [Dockerfile](https://github.com/matrix-org/synapse/tree/develop/docker)
- Docker-Compose: [synapse](https://github.com/matrix-org/synapse/blob/develop/contrib/docker/docker-compose.yml)

  - Healthcheck: noch nicht im compose, aber im Dockerfile gibt es einen
  - Secrets: ja

- Konfiguration via: homeserver.yaml
- API-Dokumentation: [übersicht](https://matrix.org/faq/#what-does-matrix-provide%3F)
- Abhängigkeiten:

  - App: [python > 3.7](https://github.com/matrix-org/synapse/blob/develop/pyproject.toml)
  - Datenbank: postgres
  - SMTP / Email: möglich

- Installationshinweise:
  - [federationstester](https://federationtester.matrix.org/)

### Authentifizierung & SSO

openid-connect, saml, cas

### Entwicklung

- Maintainership: The Matrix.org Foundation C.I.C. , Ort
- Contributors: 385 (Synapse)
- Letzte Änderung: 07.06.22
- Letzter Release / Zyklus: [1.60.0](https://github.com/matrix-org/synapse/releases/tag/v1.60.0)
- Erweiterbarkeit: viele Bots, Integrationen, Bridges vorhanden
- Geplante Entwicklung / Roadmap: ?

Überprüft am: 07.06.22

### sonstiges

- Import / Export von Userdaten:
  - einzelne chats können per element exportiert werden
  - sonst per API
  - auf Datenbank ebene vmtl etwas schwere weil die Secret Keys benötigt werden
  - Migration auf eine andere Domain nicht ohne weiteres möglich, da Username daraus abgeleitet wird.


## Notizen