ansible-collection-famedly-.../README.md
Jan Christian Grünhage 5af149d0e8 feat(modules): add synapse_register module
This module uses synapse's admin API to register users. It requires the
registration shared secret from synapse's config, and allows creating
admin users too.
2020-10-09 17:35:06 +02:00

1.1 KiB

Ansible Collection - famedly.matrix

Modules

This collection contains a few modules for managing matrix rooms and servers, as well as sending notifications from ansible to matrix.

  • matrix_login: Create an access token for a matrix account.
  • matrix_logout: Invalidates an access token.
  • matrix_notification: Sends a message to a matrix room.
  • matrix_room: Idempotently joins/creates a room with a given alias.
  • matrix_state: Ensures room state has a given content.
  • matrix_member: Ensures room memberships are correct.
  • matrix_signing_key: Creates a server signing key.
  • synapse_register: Registers a user using synapse's admin API.

You can find more information and a sample playbook for these modules in the README in ./plugins/modules/

Roles

In addition to the modules, this role also contains a few roles for deploying commonly used matrix services:

  • synapse: Homeserver, this is where your accounts live.
  • element: Web client, for using your accounts.

For details on using these, look at the README.md in the respective role directory.