mbc auth

The mbc auth command can be used to log into Matrix accounts.

To log in with mbc auth, first make sure you have your homeserver listed in the homeservers section in the maubot config (the secret can be empty). If you haven't used the mbc tool before, log into your maubot instance with mbc login. Finally, run mbc auth and fill in the parameters:

  • The homeserver is the dictionary key, i.e. server name (not URL) from the homeservers config.
  • The username can be either the username or full user ID, that doesn't matter.
  • The password is the password.

If the command says "Registration target server not found", it means you didn't add the server to homeservers properly or didn't enter the correct name in mbc.

If you want to register an account, you must pass --register as a parameter. This also requires the secret to be set in the config.

Single sign-on is also supported by using the --sso flag. When that flag is passed, the command will open the login page in a browser instead of prompting for username and password.

Additionally, there's a --update-client parameter that tells maubot to store the created access token as a client instance so you don't have to do it manually in the web interface.