ansible-infra/docs/guides/matrix-create-room.md
lilly f7c3e2146d
All checks were successful
/ build (pull_request) Successful in 50s
/ Ansible Lint (pull_request) Successful in 2m53s
/ cleanup-staging (pull_request) Successful in 37s
/ build (push) Successful in 56s
/ Ansible Lint (push) Successful in 3m8s
migrate mjolnir to draupnir
2026-09-06 14:40:45 +02:00

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 following draupnir command while substituting the copied room id:
```
!draupnir 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 `!draupnir verify` in the *CCCHH Moderation Management* room and observe that the moderation bot does not give you an error.