eimis-ans / matrix-double-bridge

docker compose for matrix and some bridges

Matrix bridge test bench

The goal of this repo is improve skills about Matrix and Matrix bridges

With the deployment of a Synapse instance with it's Element client and 2 bridges : Slack and Discord.

Prerequisites

• a machine with docker and docker-compose installed
• yq package installed :
  • https://github.com/kislyuk/yq for linux
  • https://github.com/mikefarah/yq#windows for windows

Installations

Add "matrix.local" to the hosts file :

• edit /etc/hosts for linux
• edit C:\Windows\System32\drivers\etc\hosts for Windows and add

127.0.0.1       matrix.local

Set variables

• Linux

  • Run cp .env_template .env
  • Run chmod +x setup-variables.sh
  • Set variables then run ./setup-variables.sh (this script can be run each time a line is filled in .env file)

• Windows

  • Run cp .env_template .env
  • fill it with relevant values
  • manually report this values where each placeholder is present in the code

Setup matrix

Follow the instructions there : Matrix

Setup discord bridge

Follow the instructions there : discord-bridge

Setup Slack bridge

Follow the instructions there : slack-bridge

🗨️ Chat

• It's possible to link a room to both Slack and Discord.
• bridge listened rooms aren't encrypted although it is possible https://matrix-appservice-slack.readthedocs.io/en/latest/bridge-encryption/
• PM needs puppeting for the 3rd party app and, thus, a user token https://matrix-appservice-slack.readthedocs.io/en/latest/puppeting/