changes to the docs for the new admin modifcation scripts

This commit is contained in:
prasket 2020-01-20 12:59:36 -08:00
parent 20b0e5d2c8
commit 92c6031c9f
2 changed files with 10 additions and 4 deletions

View File

@ -24,7 +24,10 @@ If you've just installed Matrix, **to finalize the installation process**, it's
-----
The script `/usr/local/bin/matrix-change-user-admin-status` may be used to change a user's admin privileges:
## Adding/Removing Administrator privileges to an existing user.
The script `/usr/local/bin/matrix-change-user-admin-status` may be used to change a user's admin privileges.
* log on to your server with ssh
* execute with the username and 0/1 (0 = non-admin | 1 = admin)

View File

@ -2,10 +2,11 @@
## Option 1 (if you are using the default matrix-postgres container):
You can reset a user's password via the Ansible playbook (make sure to edit the `<your-username>` and `<your-password>` part below):
You can reset a user's password via the 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>' --tags=update-user-password
ansible-playbook -i inventory/hosts setup.yml --extra-vars='user:w
name=<your-username> password=<your-password>' --tags=update-user-password
```
**Note**: `<your-username>` is just a plain username (like `john`), not your full `@<username>:<your-domain>` identifier.
@ -34,7 +35,9 @@ where `<password-hash>` is the hash returned by the docker command above.
Use the Synapse User Admin API as described here: https://github.com/matrix-org/synapse/blob/master/docs/admin_api/user_admin_api.rst#reset-password
This requires an access token from a server admin account. If you didn't make your account a server admin when you created it, you can use the `/usr/local/bin/matrix-change-user-admin-status` script as described in [registering-users.md](registering-users.md). Note this method will also log the user out of all of their clients while the other options do not.
This requires an access token from a server admin account. *This method will also log the user out of all of their clients while the other options do not.*
If you didn't make your account a server admin when you created it, you can use the `/usr/local/bin/matrix-change-user-admin-status` script as described in [registering-users.md](registering-users.md).
### Example:
To set @user:domain.com's password to `correct_horse_battery_staple` you could use this curl command: