Change the main address of a room or space¶

In this guide, we will change the main address of a room or space to ubuntu.com.

A room or space may have any number of addresses and the main address can be published to the public directory of the homeserver it belongs to for discovery. Changing and publishing the main address requires changes to be made by a user belonging to the homeserver of that address with power level 50 (moderator) or above.

Quick Guide¶

After inviting a user from the ubuntu.com homeserver and giving them power level 50+ (moderator), they’ll create a local address in settings, set it as the main address and turn on publishing to the homeserver’s public directory.

After that, their privileges can be removed and they don’t need to remain (see: Caveats).

Step-by-step guide¶

As the room/space admin¶

Invite a trusted Ubuntu user from the ubuntu.com homeserver to your room or space.
Set the Ubuntu user’s power level to 50 (Moderator) or above.

As an Ubuntu user¶

Enter the room or space.
Open settings:

Rooms
Right-click on the room’s icon on the left bar and click Settings.

Spaces
Click on the name of the space at the top of the left bar just below the Search field.

Click Settings.

Click Visibility.
Scroll down until you see the title Published Addresses and note the address in the Main address drop-down. If there’s no address, ask the admin what they’d like the address to be.
Scroll down until you see the title Local Addresses and click Show more if applicable.
In the address input field, enter the Main address you noted above without the leading # or trailing :ubuntu.com. E.g. an address of #my-room:matrix.org would be entered as my-room.
Click the Add button.
Scroll up until you see the title Published Addresses, click the Main address drop-down and select the new address you added. You may need to refresh your browser if it’s not visible.

Note

It’s important not to delete the local address that’s been selected as the main address because it’s a pointer to that address, not a copy.
Toggle the slider next to “Publish this room to the public in ubuntu.com’s room directory?” to “On”. You may need to refresh your browser to set it.

As the room/space admin¶

Privileges can now be removed from the invited Ubuntu user and they don’t need to remain in the room or space (see: Caveats).

Caveats¶

A room or space must have at least one Ubuntu user as a member for it to be visible on the public directory of the ubuntu.com homeserver.
In Settings for rooms, or Setting > Visibility for spaces, only an Ubuntu user can see (or toggle with power level 50+) the setting for publishing to ubuntu.com’s public directory. For everyone else it will appear off.
Members of any power level can add local addresses or delete the local addresses they’ve created even if they’re in use as the main address. Care should be taken when relying on addresses that were not created by trusted users though these addresses are easy to replace.