# Maubot notes # adding a client (i.e. a matrix user / account) You cannot add a fedora.im client via the maubot web interface, as you need to use fedora sso / ipsilon to log in. to do this, you will need the maubot package on your local machine installed from pip to give you the `mbc` (maubot control) command. then log into the maubot instance (this can be done from anywhere): ``` mbc login -s https://maubot.apps.ocp.fedoraproject.org/ -u admin -a prod ``` the password is in the secret repo, and the -a here is really just us labeling this server `prod` next, use the following command to create a new client: ``` mbc auth --sso -c -h fedora.im -s prod ``` it should launch a browser showing ipsilon, log in with the account you want to authorize as a client for matrix. the result should look something like this: ``` Opening https://fedora.ems.host/_matrix/client/v3/login/sso/redirect?redirectUrl=http://maubot.apps.ocp.fedoraproject.org/_matrix/maubot/v1/client/auth_external_sso/complete/g4br1231q12asdad Waiting for login token... Successfully created client for @zodbot:fedora.im / maubot_ABCDEFGH. ``` now if you go to the maubot admin page (https://maubot.apps.ocp.fedoraproject.org/) the account you just authorized will be listed in the clients section. # uploading / updating plugins Currently, we upload the plugins directly to the maubot instance, and they are stored in a persistent volume there. to build and upload a plugin: go to where you have the plugin source, eg: ``` git clone https://github.com/fedora-infra/maubot-fedora.git cd maubot-fedora/ ``` and run the command to [sadf](http://google.com) build and upload the plugin to the maubot instance: ``` mbc build -u -s prod; ``` the updated plugin should now me running. # creating an instance next create an instance on the webui for the plugin on your client. # checking logs you can view the maubot logs with: ``` mbc logs prod ```