Compare commits

...

4 commits

Author SHA1 Message Date
f2e81c5150 Update README.md
All checks were successful
build / release (push) Successful in 5s
build / docker (push) Successful in 10s
2025-05-28 15:59:49 +02:00
c1757005b6 Update README.md
All checks were successful
build / release (push) Successful in 5s
build / docker (push) Successful in 9s
2025-05-28 15:59:07 +02:00
3ce0786576 Update docker-compose.yml
All checks were successful
build / release (push) Successful in 5s
build / docker (push) Successful in 9s
2025-05-28 15:58:31 +02:00
4bbbe55f38 Update README.md
All checks were successful
build / release (push) Successful in 6s
build / docker (push) Successful in 12s
2025-05-28 15:57:55 +02:00
2 changed files with 82 additions and 74 deletions

152
README.md
View file

@ -1,75 +1,85 @@
## Matrix Jitsi-admin Bot
# Matrix Meetling Bot
Dies ist ein Bot, der für die Verwaltung von Jitsi-Meetings über Matrix erstellt wurde. Der Bot ermöglicht die Steuerung und Verwaltung von Meetings über eine Matrix-Instanz.
### Installation
#### Token erstellen
1. Klonen des Repositorys:
```
git clone https://de-h2-git01.h2.home/emanuel.holzmann/matrix-bot.git
```
2. Installation der benötigten Pakete:
```
npm install
```
3. Generieren des Tokens:
Führen Sie den folgenden Befehl aus und ersetzen Sie `username`, `passwort` und `https://matrixdomain.org` durch die entsprechenden Anmeldeinformationen:
```shell
MATRIX_USERNAME=username MATRIX_PASSWORD=passwort MATRIX_URL=https://matrixdomain.org node login.mjs
```
Der generierte Access-Token muss sicher aufbewahrt werden, da er der Schlüssel für den Docker-Container ist.
#### Container starten
1. Erneutes Checkout der Anwendung (optional, wenn bereits geklont):
```
git clone https://de-h2-git01.h2.home/emanuel.holzmann/matrix-bot.git
```
2. Wechseln in das Verzeichnis:
```
cd matrix-bot
```
3. Bauen der Anwendung und Starten des Containers mit `docker-compose`:
Führen Sie den folgenden Befehl aus und ersetzen Sie `tokenKommtHIerHer` durch den generierten Accesstoken aus Schritt 1, `https://matrixdomain.org` und `https://jitsi-admin-url.de` müssen durch reale URLs ersetzt werden:
```shell
MATRIX_TOKEN=tokenKommtHIerHer MATRIX_URL=https://matrixdomain.org JITSI_ADMIN_URL=https://jitsi-admin-url.de docker-compose up --build -d
```
4. Berechtigungen für das Volume festlegen:
```shell
chown -R 1000:1000 /var/lib/docker/volumes/matrix-bot_secret_data/
```
5. Possible Arguments
````shell
MATRIX_URL=<Matrix Url>|https://matrix.org
MATRIX_TOKEN=<Matrix Token>
MATRIX_PASSWORD=<Matrix password>
JITSI_ADMIN_URL=<jitsi admin url>|https://jitsi-admin.de
MATRIX_DISPLAYNAME=<displayName of the bot>|"Raumassistent"
SHOW_WARNING_OF_MIM=<boolean show if a warning>|false
````
### Hinweise
Stellen Sie sicher, dass die Umgebungsvariablen korrekt gesetzt sind und die Zugangsdaten sicher behandelt werden. Der Bot ermöglicht die Verwaltung von Jitsi-Meetings über Matrix und kann entsprechend konfiguriert werden.
Ein Bot zur Verwaltung von **Jitsi-Meetings** über eine **Matrix-Instanz**. Mit diesem Bot lassen sich Jitsi-Sitzungen direkt über Matrix steuern und verwalten - ideal für automatisierte Konferenzen und Raumverwaltung.
---
Bitte beachten Sie, dass die Pfadangaben, Token und URLs entsprechend Ihren tatsächlichen Konfigurationen und Anforderungen angepasst werden müssen.
## 🚀 Funktionen
- Starten und Verwalten von Jitsi-Meetings über Matrix
- Konfigurierbare Umgebungsvariablen
- Integration über Docker möglich
---
## 🛠️ Installation & Einrichtung
### 1. 🔑 Matrix-Zugangstoken generieren
Führe den folgenden Befehl aus, um einen Access-Token zu generieren. Ersetze `username`, `passwort` und die URL durch deine echten Zugangsdaten:
```bash
docker run --rm -it \
-e MATRIX_USERNAME=username \
-e MATRIX_PASSWORD=passwort \
-e MATRIX_URL=https://matrixdomain.org \
git.h2-invent.com/meetling/matrix-bot:2.2.7 \
node login.mjs
```
> 💡 **Hinweis:** Bewahre den generierten Token sicher auf - er wird zur Authentifizierung im Container verwendet.
---
## 🐳 Deployment mit Docker
### 1. 📂 Docker Compose Download
Falls noch nicht geschehen:
```bash
mkdir /opt/matrix-bot
cd /opt/matrix-bot
wget https://git.h2-invent.com/Meetling/matrix-bot/raw/branch/master/docker-compose.yml
```
### 2. ⚙️ Container starten
Baue das Docker-Image und starte den Container. Ersetze dabei:
- `tokenKommtHierHer`: den zuvor generierten Matrix Access-Token
- `https://matrixdomain.org`: deine Matrix-Instanz
- `https://jitsi-admin-url.de`: die Jitsi-Admin-URL
```bash
MATRIX_TOKEN=tokenKommtHierHer \
MATRIX_URL=https://matrixdomain.org \
JITSI_ADMIN_URL=https://jitsi-admin-url.de \
docker-compose up -d
```
### 3. 🔐 Berechtigungen setzen
Stelle sicher, dass das Docker-Volume korrekt gesetzt ist:
---
## ⚙️ Konfigurierbare Umgebungsvariablen
| Variable | Beschreibung | Beispielwert |
|----------------------|------------------------------------------------------------------|-----------------------------------|
| `MATRIX_URL` | URL der Matrix-Instanz | `https://matrix.org` |
| `MATRIX_TOKEN` | Der generierte Access-Token | _deinToken_ |
| `MATRIX_PASSWORD` | (Optional) Passwort des Matrix-Accounts | `geheimesPasswort` |
| `JITSI_ADMIN_URL` | URL zum Jitsi-Admin-Endpunkt | `https://jitsi-admin.de` |
| `MATRIX_DISPLAYNAME` | Anzeigename des Bots in Matrix | `"Raumassistent"` |
| `SHOW_WARNING_OF_MIM`| Gibt an, ob Warnungen angezeigt werden sollen (true/false) | `false` |
---
## 📌 Hinweise
- Stelle sicher, dass alle Zugangsdaten und Tokens **sicher gespeichert** und **nicht öffentlich geteilt** werden.
- Die in der README genannten URLs und Tokens dienen nur als **Beispiele** - bitte passe sie an deine Umgebung an.
- Der Bot bietet eine flexible Möglichkeit, Jitsi-Meetings über Matrix zu automatisieren.

View file

@ -1,8 +1,6 @@
version: '3.7'
services:
matrix-bot:
image: h2invent/jitsi-admin-matrix-bot:latest
image: git.h2-invent.com/meetling/matrix-bot:2.2.7
environment:
MATRIX_URL: ${MATRIX_URL}
MATRIX_TOKEN: ${MATRIX_TOKEN}