53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
---
|
|
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.
|
|
|