Your submission was sent successfully! Close

You have successfully unsubscribed! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates about Ubuntu and upcoming events where you can meet our team.Close

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:

  1. Invite a trusted Ubuntu user from the ubuntu.com homeserver to your room or space.

  2. Set the Ubuntu user’s power level to 50 (Moderator) or above.

Ubuntu user:

  1. Enter the room or space.

  2. 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”.

  3. 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.
  4. Scroll down until you see the title “Local Addresses” and click “Show more” if applicable.

  5. In the address input field, enter the “Main address” you noted above without the leading # or trailing :ubuntu.com

    Ex: An address of #my-room:matrix.org would be entered as my-room

    then click the “Add” button.

  6. 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.
  7. 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.

This page was last modified 5 months ago. Help improve this document in the forum.