matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-heisenbridge.md
Slavi Pantaleev 410a915a8a Move roles/matrix* to roles/custom/matrix*
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.
2022-11-03 09:11:29 +02:00

2 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.