Matrix Chat Help

Accept Account Invitation

TODO

Access Matrix Chat

The most common and easiest chat clients for Matrix are made by Element.

  • Element Web - Web client for Matrix
    • Click sign in
    • Under Home Server, click edit, and set it to https://spudnik.potatostack.com
  • Element Apps
    • Cross-platform desktop apps for Windows, Mac, and Linux
    • Element X
      • Supposed to be their "newest" app but I find that it is lacking some full functionality
      • This may change as they continue to update the app
    • Classic Element Mobile App - This is the app that I use and it works pretty well

Login to Matrix Chat

  • Username and Password (Legacy)
    • You can log into Matrix using your originally assigned username and (hopefully changed) password.
  • Potatostack Keycloak
    • Clicking "Continue with Potatostack Keycloak" will redirecy you to the Potatostack Keycloak portal (served by auth.hudaknet.com) to login.

Link Keycloak Account to Existing Account

What this means for you

  • Your Matrix ID will stay the same
  • Your messages, rooms, and encryption remain intact
  • Login will now use SSO instead of local passwords

What you need to do (one-time setup – 5 minutes)

  1. Log in to Matrix using your current username and password
  2. Go to Settings → Security & Privacy
  3. Click “Link SSO / External account”
  4. Log in using your new SSO account
  5. Done ✅

After this, you will use SSO for future logins.

Important notes

  • You may be asked to re-verify your devices (normal and expected)
  • Each device (phone, laptop, tablet) must log in once using SSO
  • Logging out of SSO does not automatically log you out of the Matrix app