mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-11-06 10:47:32 +01:00
bf5373479b
Overall the playbook uses the expression "Add the following configuration to your `inventory/host_vars/matrix.DOMAIN/vars.yml` file:" with the heading "Adjusting the playbook configuration" for sections to explain what to be added as variables Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
48 lines
2.7 KiB
Markdown
48 lines
2.7 KiB
Markdown
# Setting up Synapse Auto Invite Accept (optional)
|
|
|
|
The playbook can install and configure [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) for you.
|
|
|
|
See that project's [documentation](https://github.com/matrix-org/synapse-auto-accept-invite) to learn what it does and why it might be useful to you.
|
|
In short, it automatically accepts room invites. You can specify that only 1:1 room invites are auto-accepted. Defaults to false if not specified.
|
|
|
|
**NOTE**: Synapse [v1.109.0](https://github.com/element-hq/synapse/releases/tag/v1.109.0), the same feature [has been merged](https://github.com/element-hq/synapse/pull/17147) into Synapse (see the [Native alternative](#native-alternative) section below). You'd better use the native feature, instead of the [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) 3rd party module.
|
|
|
|
|
|
## Configuration
|
|
|
|
If you decide that you'd like to let this playbook install the [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite module for you, add the following configuration to your `inventory/host_vars/matrix.DOMAIN/vars.yml` file:
|
|
|
|
```yaml
|
|
matrix_synapse_ext_synapse_auto_accept_invite_enabled: true
|
|
|
|
matrix_synapse_ext_synapse_auto_accept_invite_accept_invites_only_direct_messages: true
|
|
```
|
|
|
|
### Synapse worker deployments
|
|
|
|
In a [workerized Synapse deployment](https://github.com/spantaleev/matrix-docker-ansible-deploy/blob/c9a842147e09647c355799ca024d65a5de66b099/docs/configuring-playbook-synapse.md#load-balancing-with-workers) it is possible to run this module on a worker to reduce the load on the main process (Default is `null`). For example, add this to your configuration:
|
|
|
|
```yaml
|
|
matrix_synapse_ext_synapse_auto_accept_invite_worker_to_run_on: 'matrix-synapse-worker-generic-0'
|
|
```
|
|
|
|
There might be an [issue with federation](https://github.com/matrix-org/synapse-auto-accept-invite/issues/18).
|
|
|
|
|
|
## Native alternative
|
|
|
|
Since Synapse [v1.109.0](https://github.com/element-hq/synapse/releases/tag/v1.109.0), the functionality provided by the [synapse-auto-invite-accept](https://github.com/matrix-org/synapse-auto-accept-invite) 3rd party module [has been made](https://github.com/element-hq/synapse/pull/17147) part of Synapse.
|
|
|
|
Here's example configuration for using the **native** Synapse feature:
|
|
|
|
```yml
|
|
matrix_synapse_auto_accept_invites_enabled: true
|
|
|
|
# Default settings below. Uncomment and adjust if necessary.
|
|
# matrix_synapse_auto_accept_invites_only_for_direct_messages: false
|
|
# matrix_synapse_auto_accept_invites_only_from_local_users: false
|
|
|
|
# If workers are enabled, you may delegate usage to a specific worker.
|
|
# matrix_synapse_auto_accept_invites_worker_to_run_on: 'matrix-synapse-worker-generic-0'
|
|
```
|