add guide about matrix room creation
This commit is contained in:
parent
70cc70abf4
commit
213c0f678d
1 changed files with 53 additions and 0 deletions
53
docs/guides/matrix-create-room.md
Normal file
53
docs/guides/matrix-create-room.md
Normal file
|
|
@ -0,0 +1,53 @@
|
||||||
|
---
|
||||||
|
title: "Matrix: Create a New Room"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Matrix: Create a New Room
|
||||||
|
|
||||||
|
!!! success "Goal"
|
||||||
|
|
||||||
|
Create a new matrix room for a CCCHH group or function with correct protections and permissions
|
||||||
|
|
||||||
|
## 1. Create the Room
|
||||||
|
|
||||||
|
Rooms are always created by the *CCCHH-Admin* Account whose credentials can be found in *infra-secrets*.
|
||||||
|
To create a room, log in to https://element.hamburg.ccc.de and click on *New Conversation* -> *New Room*.
|
||||||
|
Enter a Room Name and optionally give it an address on the *hamburg.ccc.de* server.
|
||||||
|
|
||||||
|
## 2. Configure Room Metadata
|
||||||
|
|
||||||
|
Once the room is created, please give it a topic and if possible a room icon.
|
||||||
|
This makes it easier to distinguish the many rooms we have.
|
||||||
|
|
||||||
|
## 3. Invite the Moderation-Bot
|
||||||
|
|
||||||
|
Either perform the following steps via the GUI or enter the displayed commands into the chat window of the new room:
|
||||||
|
|
||||||
|
|
||||||
|
1. Invite the User `@moderation:hamburg.ccc.de` to the new room
|
||||||
|
```
|
||||||
|
/invite @moderation:hamburg.ccc.de
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Give the moderation bot *Admin* Power-Level so that it can properly enforce all protections
|
||||||
|
```
|
||||||
|
/op @moderation:hamburg.ccc.de 100
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. Set Up Room Protection
|
||||||
|
|
||||||
|
We have now added the moderation bot to the room but this is not enough.
|
||||||
|
The bot needs to be told explicitly which rooms it should protect and the newly created one therefore needs to be added to that list.
|
||||||
|
|
||||||
|
First, note down the *Internal Room ID* which can be found in the new Rooms settings under the *Advanced* tab.
|
||||||
|
Then enter the *CCCHH Moderation Management* room and write the follogin mjolnir command while substituting the copied room id:
|
||||||
|
|
||||||
|
```
|
||||||
|
!mjolnir rooms add <room-id>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Closing Up
|
||||||
|
|
||||||
|
You should now have a new Matrix Room under moderation protection.
|
||||||
|
To verify that everything was done correctly, you can enter `!mjolnir verify` in the *CCCHH Moderation Management* room and observe that the moderation bot does not give you an error.
|
||||||
|
|
||||||
Loading…
Reference in a new issue