Matrix How-To: Difference between revisions

From HOPE Wiki
Mal (talk | contribs)
m formatting
Mal (talk | contribs)
more migration bits
Line 1: Line 1:
=== Hope Matrix Sunset ===
== Migrate your account! ==
The hope.net Matrix server will be shut down at some point after the conference. Before then, be sure to:
'''The hope.net Matrix server will be shut down''' a while after the conference ends. When this happens, all accounts, rooms, and communities on riot.hope.net/matrix.hope.net will disappear.
Before that happens, be sure to:
* Make contact with your new friends outside Matrix, or with accounts (both you and them!) not on hope.net:
* Make contact with your new friends outside Matrix, or with accounts (both you and them!) not on hope.net:
* Create a new Matrix account on another homeserver, for example https://chat.fairydust.space/
* Create a new Matrix account on another homeserver, for example https://chat.fairydust.space/ or https://riot.privacytools.io/
* You may find the [https://ems.element.io/tools/matrix-migration|account migration tool] helpful
* If you want to, [https://ems.element.io/tools/matrix-migration| migrate your account] from hope.net to your new homeserver
** Your old homeserver would be matrix.hope.net, and your new one would be e.g. matrix.fairydust.space
** Your old homeserver would be matrix.hope.net, and your new one would be e.g. matrix.fairydust.space
** For best results, sign out of both accounts while it runs - Make sure you wrote down your encryption key before signing out!
* Join #afterhope2020:fairydust.space to keep chatting
* Join #afterhope2020:fairydust.space to keep chatting


=== How to join chat ===
== How to join chat ==


* Create or sign in to a Matrix account
* Create or sign in to a Matrix account
Line 14: Line 16:
For help with the bot, please see the [[Conference_bot|CoreBot help]].
For help with the bot, please see the [[Conference_bot|CoreBot help]].


=== Using the Web Client ===
== Using the Web Client ==


Visit https://chat.fairydust.space/ to create an account ([[Matrix_How-To#How_to_create_your_HOPE_Matrix_account_on_the_web_.28slideshow.29|walkthrough]]), then send the [[Conference_bot|bot]] (@corebot:hope.net) a direct message with the command <code>ticket</code> then your ticket code. [[Conference_bot|More information]]
Visit https://chat.fairydust.space/ to create an account ([[Matrix_How-To#How_to_create_your_HOPE_Matrix_account_on_the_web_.28slideshow.29|walkthrough]]), then send the [[Conference_bot|bot]] (@corebot:hope.net) a direct message with the command <code>ticket</code> then your ticket code. [[Conference_bot|More information]]


=== Desktop and Mobile Matrix Clients ===
== Desktop and Mobile Matrix Clients ==


If you wish to use your own client instead of riot.hope.net, we recommend [https://element.io/get-started element]. It supports iOS, Android, and desktop (Windows/Mac/Linux).
If you wish to use your own client instead of riot.hope.net, we recommend [https://element.io/get-started element]. It supports iOS, Android, and desktop (Windows/Mac/Linux).
Line 28: Line 30:
[[File:Matrix-mobile-homeserver.png|440px|Screenshot overview of setting a custom homeserver in element]]
[[File:Matrix-mobile-homeserver.png|440px|Screenshot overview of setting a custom homeserver in element]]


=== Troubleshooting ===
== Troubleshooting ==


* '''The desktop client isn't working'''<br>Wait a few minutes and try again. Make sure you're using the correct homeserver (see above)! If it's still not working, try the web client.
* '''The desktop client isn't working'''<br>Wait a few minutes and try again. Make sure you're using the correct homeserver (see above)! If it's still not working, try the web client.
* '''I'm missing a channel''' or '''I can't join a channel'''<br>Send the bot the ticket command and your code again, it will try again to invite you to rooms.
* '''I'm missing a channel''' or '''I can't join a channel'''<br>Send the bot the ticket command and your code again, it will try again to invite you to rooms.


=== How to create your HOPE Matrix account on the web (slideshow) ===
== How to create your HOPE Matrix account on the web (slideshow) ==


Note: adding your email for registration is ''optional''. If you add an email you are required to verify it before you can log in.
Note: adding your email for registration is ''optional''. If you add an email you are required to verify it before you can log in.
Line 51: Line 53:
[[File:Matrix_community_tooltip.png|420px|matrix community tooltip]]
[[File:Matrix_community_tooltip.png|420px|matrix community tooltip]]


=== Join other unoffical rooms ===
== Join other unofficial rooms ==


If you want to see the unofficial rooms click the icon to the right of the search bar to explore other rooms
If you want to see the unofficial rooms click the icon to the right of the search bar to explore other rooms


[[File:Other_rooms.png|matrix legend]]
[[File:Other_rooms.png|matrix legend]]

Revision as of 02:03, 3 August 2020

Migrate your account!

The hope.net Matrix server will be shut down a while after the conference ends. When this happens, all accounts, rooms, and communities on riot.hope.net/matrix.hope.net will disappear. Before that happens, be sure to:

  • Make contact with your new friends outside Matrix, or with accounts (both you and them!) not on hope.net:
  • Create a new Matrix account on another homeserver, for example https://chat.fairydust.space/ or https://riot.privacytools.io/
  • If you want to, migrate your account from hope.net to your new homeserver
    • Your old homeserver would be matrix.hope.net, and your new one would be e.g. matrix.fairydust.space
    • For best results, sign out of both accounts while it runs - Make sure you wrote down your encryption key before signing out!
  • Join #afterhope2020:fairydust.space to keep chatting

How to join chat

  • Create or sign in to a Matrix account
  • Talk to our CoreBot to get access to the chat rooms

For help with the bot, please see the CoreBot help.

Using the Web Client

Visit https://chat.fairydust.space/ to create an account (walkthrough), then send the bot (@corebot:hope.net) a direct message with the command ticket then your ticket code. More information

Desktop and Mobile Matrix Clients

If you wish to use your own client instead of riot.hope.net, we recommend element. It supports iOS, Android, and desktop (Windows/Mac/Linux).

You will likely need to set the client to use your homeserver, like matrix.fairydust.space or matrix.hope.net depending on where you created your account. You can see a screenshot of how to do this below.

Once you are signed in to your account, send the bot (@corebot:hope.net) a direct message with the command ticket then your ticket code. More information

Screenshot overview of setting a custom homeserver in element

Troubleshooting

  • The desktop client isn't working
    Wait a few minutes and try again. Make sure you're using the correct homeserver (see above)! If it's still not working, try the web client.
  • I'm missing a channel or I can't join a channel
    Send the bot the ticket command and your code again, it will try again to invite you to rooms.

How to create your HOPE Matrix account on the web (slideshow)

Note: adding your email for registration is optional. If you add an email you are required to verify it before you can log in.

A legend of some common functions in Element (Riot) are shown here.

matrix legend matrix community tooltip

Join other unofficial rooms

If you want to see the unofficial rooms click the icon to the right of the search bar to explore other rooms

matrix legend