75 lines
No EOL
2.4 KiB
Markdown
75 lines
No EOL
2.4 KiB
Markdown
## Matrix Jitsi-admin 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.
|
|
|
|
---
|
|
|
|
Bitte beachten Sie, dass die Pfadangaben, Token und URLs entsprechend Ihren tatsächlichen Konfigurationen und Anforderungen angepasst werden müssen. |