Docs: update README
This commit is contained in:
parent
60ac9211e1
commit
d791a7d903
1 changed files with 32 additions and 2 deletions
34
README.md
34
README.md
|
@ -4,5 +4,35 @@ Unser Matrix-Bot, der Gruppen, Gruppenmitgliedschaften und Rechte verwaltet.
|
||||||
|
|
||||||
# How it works
|
# How it works
|
||||||
|
|
||||||
1. load all users from matrix
|
1. create default rooms
|
||||||
2. add all users to the default channels
|
2. load users and their groups from matrix and ldap
|
||||||
|
3. create rooms for all projects which have `sophomorixMailList=TRUE`
|
||||||
|
4. load all rooms (created by the bot) and their power levels from matrix
|
||||||
|
5. sync user memberships and power levels
|
||||||
|
|
||||||
|
# How to use
|
||||||
|
|
||||||
|
.matrix-bot.env:
|
||||||
|
```env
|
||||||
|
MATRIX_BOT_LDAP_URI="ldap://10.0.0.1"
|
||||||
|
MATRIX_BOT_LDAP_BASE_DN=DC=linuxmuster,DC=lan
|
||||||
|
MATRIX_BOT_LDAP_BIND_DN=CN=global-binduser,OU=Management,OU=GLOBAL,DC=linuxmuster,DC=lan
|
||||||
|
MATRIX_BOT_LDAP_BIND_DN_PASSWORD=SomeSuperSafePassword
|
||||||
|
MATRIX_BOT_MATRIX_SERVER="https://matrix.org"
|
||||||
|
MATRIX_BOT_MATRIX_DOMAIN="matrix.org"
|
||||||
|
MATRIX_BOT_MATRIX_SPACE_ID="!bajjed:matrix.org"
|
||||||
|
MATRIX_BOT_MATRIX_USERNAME="synapse"
|
||||||
|
MATRIX_BOT_MATRIX_PASSWORD="SomeSuperSafePassword"
|
||||||
|
MATRIX_BOT_DEFAULT_ROOMS="info,talk,show"
|
||||||
|
MATRIX_BOT_ADMIN_GROUP="p_admin"
|
||||||
|
MATRIX_BOT_MODERATOR_GROUP="p_moderator"
|
||||||
|
```
|
||||||
|
|
||||||
|
docker-compose.yaml:
|
||||||
|
```yaml
|
||||||
|
version: "3"
|
||||||
|
services:
|
||||||
|
matrix-bot:
|
||||||
|
image: git.makerlab-murnau.de/makerlab/matrix-bot:latest
|
||||||
|
env_file: .matrix-bot.env
|
||||||
|
```
|
Loading…
Reference in a new issue