ansible-infra/docs/guides/matrix-create-room.md

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.