This paves the way for installing other roles into `roles/galaxy` using `ansible-galaxy`, similar to how it's done in: - https://github.com/spantaleev/gitea-docker-ansible-deploy - https://github.com/spantaleev/nextcloud-docker-ansible-deploy In the near future, we'll be removing a lot of the shared role code from here and using upstream roles for it. Some of the core `matrix-*` roles have already been extracted out into other reusable roles: - https://github.com/devture/com.devture.ansible.role.postgres - https://github.com/devture/com.devture.ansible.role.systemd_docker_base - https://github.com/devture/com.devture.ansible.role.timesync - https://github.com/devture/com.devture.ansible.role.vars_preserver - https://github.com/devture/com.devture.ansible.role.playbook_runtime_messages - https://github.com/devture/com.devture.ansible.role.playbook_help We just need to migrate to those.
2.0 KiB
Setting up Heisenbridge (optional)
Note: bridging to IRC can also happen via the matrix-appservice-irc bridge supported by the playbook.
The playbook can install and configure Heisenbridge - the bouncer-style IRC bridge for you.
See the project's README to learn what it does and why it might be useful to you. You can also take a look at this demonstration video.
Configuration
Below are the common configuration options that you may want to set, exhaustive list is in the bridge's defaults var file.
At a minimum, you only need to enable the bridge to get it up and running (inventory/host_vars/matrix.DOMAIN/vars.yml
):
matrix_heisenbridge_enabled: true
# set owner (optional)
matrix_heisenbridge_owner: "@you:your-homeserver"
# to enable identd on host port 113/TCP (optional)
matrix_heisenbridge_identd_enabled: true
That's it! A registration file is automatically generated during the setup phase.
Setting the owner is optional as the first local user to DM @heisenbridge:your-homeserver
will be made the owner.
If you are not using a local user you must set it as otherwise you can't DM it at all.
Usage
After the bridge is successfully running just DM @heisenbridge:your-homeserver
to start setting it up.
Help is available for all commands with the -h
switch.
If the bridge ignores you and a DM is not accepted then the owner setting may be wrong.
You can also learn the basics by watching this demonstration video.
If you encounter issues or feel lost you can join the project room at #heisenbridge:vi.fi for help.