Accept Account Invitation

1. You will get an email from No-Reply Hudaknet <[email protected]>
2. The email will say that you were invited to the Potatostack organization and provide a link to join the organization
3. Click on the link to bring you to the account registration page on auth.hudaknet.com
4. Fill out the registration form for "Potatostack Keycloak"
   • Note that your username will be your login to Keycloak as well as your username for Matrix
   • Note: You can change your display name later in the Element client
5. Click "Register"
6. You will be asked to verify your email
7. Once your email is verified, you will be taken to your Keycloak account page

Configure Your Keycloak Account

• You can access your Keycloak account here
• You can set up MFA or Passkey under Account security > Signing in
  • Two-factor authentication - You can set up an MFA app for your account
  • Passwordless - You can set up your passkey
  • Password - You can change your password

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.

Public Channels

There should be some public channels avaiable including but not limited to:

• announcements
• general
• home-automation
• homelab

You can join them yourself or reach out to Mike to invite you.

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 (on Element desktop app) (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.

Note: This may automatically be done for you on the server-side. If you log in with Keycloak and all of your messages and history is present, it was automatically linked for you.

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