matrix-docker-ansible-deploy/docs/registering-users.md
2018-11-28 11:02:15 +01:00

1.2 KiB

Registering users

Run this to create a new user account on your Matrix server.

You can do it via this Ansible playbook (make sure to edit the <your-username> and <your-password> part below):

ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=<your-username> password=<your-password> admin=<yes|no>' --tags=register-user

or using the command-line after SSH-ing to your server (requires that all services have been started):

/usr/local/bin/matrix-synapse-register-user <your-username> <your-password> <admin access: 0 or 1>

Note: <your-username> is just a plain username (like john), not your full @<username>:<your-domain> identifier.

You can then log in with that user via the riot-web service that this playbook has created for you at a URL like this: https://riot.<domain>/.


If you've just installed Matrix, to finalize the installation process, it's best if you proceed to Configuring service discovery via .well-known


The script /usr/local/bin/matrix-make-user-admin may be used to upgrade a user's privileges:

  • log on to your server with ssh

  • execute with the username:

    /usr/local/bin/matrix-make-user-admin