How-to change the main address of a room or space to ubuntu.com
Changing 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 homeserver it belongs to for discovery.
Changing and publishing the main address requires changes 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:
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.
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.comEx: An address of
#my-room:matrix.orgwould be entered asmy-roomthen 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.
Room/Space Admin:
- Privileges can 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 ubuntu.com’s 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.