mirror/matrix-docker-ansible-deploy
1
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2025-01-05 15:57:13 +01:00
Code Issues Packages Projects Releases Wiki Activity

Replace <your-password> with YOUR_PASSWORD_HERE

Browse Source 
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
This commit is contained in:
Suguru Hirahara 2024-11-17 01:59:41 +09:00
parent 4bf5f30fbd
commit 26d5ec9a46
No known key found for this signature in database
GPG Key ID: E4F9743DAB4B7B75
3 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/quick-start.md
View File

@ -108,11 +108,11 @@ As you have configured your brand new server and the client, you need to **creat
To register a user via this Ansible playbook, run the command below on your local computer. To register a user via this Ansible playbook, run the command below on your local computer.
**Notes**: **Notes**:
- Before running it, make sure to edit `YOUR_USERNAME_HERE` and `<your-password>` - Before running it, make sure to edit `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE`
- In the command below, `YOUR_USERNAME_HERE` is just a plain username (like `john`), not your full `@user:example.com` identifier - In the command below, `YOUR_USERNAME_HERE` is just a plain username (like `john`), not your full `@user:example.com` identifier
```sh ```sh
ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=<your-password> admin=<yes|no>' --tags=register-user ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=YOUR_PASSWORD_HERE admin=<yes|no>' --tags=register-user
# Example: `ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=john password=secret-password admin=yes' --tags=register-user` # Example: `ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=john password=secret-password admin=yes' --tags=register-user`
``` ```

12
docs/registering-users.md
View File

@ -22,10 +22,10 @@ After registering a user (using one of the methods below), **you can log in with
It's best to register users via the Ansible playbook, because it works regardless of homeserver implementation (Synapse, Dendrite, etc) or usage of [Matrix Authentication Service](configuring-playbook-matrix-authentication-service.md) (MAS). It's best to register users via the Ansible playbook, because it works regardless of homeserver implementation (Synapse, Dendrite, etc) or usage of [Matrix Authentication Service](configuring-playbook-matrix-authentication-service.md) (MAS).
To register a user via this Ansible playbook (make sure to edit the `YOUR_USERNAME_HERE` and `<your-password>` part below): To register a user via this Ansible playbook (make sure to edit the `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE` part below):
```sh ```sh
just register-user YOUR_USERNAME_HERE <your-password> <admin access: yes or no> just register-user YOUR_USERNAME_HERE YOUR_PASSWORD_HERE <admin access: yes or no>
# Example: `just register-user john secret-password yes` # Example: `just register-user john secret-password yes`
``` ```
@ -33,7 +33,7 @@ just register-user YOUR_USERNAME_HERE <your-password> <admin access: yes or no>
**or** by invoking `ansible-playbook` manually: **or** by invoking `ansible-playbook` manually:
```sh ```sh
ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=<your-password> admin=<yes|no>' --tags=register-user ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=YOUR_PASSWORD_HERE admin=<yes|no>' --tags=register-user
# Example: `ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=john password=secret-password admin=yes' --tags=register-user` # Example: `ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=john password=secret-password admin=yes' --tags=register-user`
``` ```
@ -45,7 +45,7 @@ ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNA
If you're using the [Synapse](configuring-playbook-synapse.md) homeserver implementation (which is the default), you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)): If you're using the [Synapse](configuring-playbook-synapse.md) homeserver implementation (which is the default), you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)):
```sh ```sh
/matrix/synapse/bin/register-user YOUR_USERNAME_HERE <your-password> <admin access: 0 or 1> /matrix/synapse/bin/register-user YOUR_USERNAME_HERE YOUR_PASSWORD_HERE <admin access: 0 or 1>
# Example: `/matrix/synapse/bin/register-user john secret-password 1` # Example: `/matrix/synapse/bin/register-user john secret-password 1`
``` ```
@ -55,7 +55,7 @@ If you're using the [Synapse](configuring-playbook-synapse.md) homeserver implem
If you're using the [Dendrite](./configuring-playbook-dendrite.md) homeserver implementation, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)): If you're using the [Dendrite](./configuring-playbook-dendrite.md) homeserver implementation, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)):
```sh ```sh
/matrix/dendrite/bin/create-account YOUR_USERNAME_HERE <your-password> <admin access: 0 or 1> /matrix/dendrite/bin/create-account YOUR_USERNAME_HERE YOUR_PASSWORD_HERE <admin access: 0 or 1>
# Example: `/matrix/dendrite/bin/create-account john secret-password 1` # Example: `/matrix/dendrite/bin/create-account john secret-password 1`
``` ```
@ -65,7 +65,7 @@ If you're using the [Dendrite](./configuring-playbook-dendrite.md) homeserver im
If you're using the [Matrix Authentication Service](./configuring-playbook-matrix-authentication-service.md) and your existing homeserver (most likely [Synapse](./configuring-playbook-synapse.md)) is delegating authentication to it, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)): If you're using the [Matrix Authentication Service](./configuring-playbook-matrix-authentication-service.md) and your existing homeserver (most likely [Synapse](./configuring-playbook-synapse.md)) is delegating authentication to it, you can register users via the command-line after **SSH**-ing to your server (requires that [all services have been started](#starting-the-services)):
```sh ```sh
/matrix/matrix-authentication-service/bin/register-user YOUR_USERNAME_HERE <your-password> <admin access: 0 or 1> /matrix/matrix-authentication-service/bin/register-user YOUR_USERNAME_HERE YOUR_PASSWORD_HERE <admin access: 0 or 1>
# Example: `/matrix/matrix-authentication-service/bin/register-user john secret-password 1` # Example: `/matrix/matrix-authentication-service/bin/register-user john secret-password 1`
``` ```

4
docs/updating-users-passwords.md
View File

@ -2,10 +2,10 @@
## Option 1 (if you are using the integrated Postgres database): ## Option 1 (if you are using the integrated Postgres database):
You can reset a user's password via the Ansible playbook (make sure to edit the `YOUR_USERNAME_HERE` and `<your-password>` part below): You can reset a user's password via the Ansible playbook (make sure to edit the `YOUR_USERNAME_HERE` and `YOUR_PASSWORD_HERE` part below):
``` ```
ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=<your-password>' --tags=update-user-password ansible-playbook -i inventory/hosts setup.yml --extra-vars='username=YOUR_USERNAME_HERE password=YOUR_PASSWORD_HERE' --tags=update-user-password
``` ```
**Note**: `YOUR_USERNAME_HERE` is just a plain username (like `john`), not your full `@<username>:example.com` identifier. **Note**: `YOUR_USERNAME_HERE` is just a plain username (like `john`), not your full `@<username>:example.com` identifier.