ChatMatrix: Difference between revisions

From FlowerHouseWiki
 
(35 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{ContainerInfo
{{ContainerInfo
|image = Juypter.png
|image = Matrix-logo.png
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|MAC = BE:B1:89:38:28:44
|MAC = BE:B1:89:38:28:44
Line 14: Line 14:
__TOC__
__TOC__
== Basic Setup ==
== Basic Setup ==
<p>Be up to date</p>
<syntaxhighlight lang="console">
apt update && apt upgrade
</syntaxhighlight>
<p>Change timezone</p>
<syntaxhighlight lang="console">
timedatectl set-timezone Europe/Berlin
</syntaxhighlight>
<p>Change locales to de_AT.UTF-8 for special characters</p>
<syntaxhighlight lang="console">
dpkg-reconfigure locales
</syntaxhighlight>
=== Installation ===
=== Installation ===
<p>Install required packages</p>
<p>Install required packages</p>
Line 87: Line 103:
</syntaxhighlight>
</syntaxhighlight>


=== Configuration ===
=== Setting up reverse proxy ===
<p>Create random key and save it</p>
<p>NGINX Proxy Manager configuration without exposing admin API</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console" line>
cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1
Details:
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 80
Custom Locations:
  location: ~ ^(/_matrix|/_synapse/client)
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 8008
Advanced:
  listen 8448 ssl http2 default_server;
  listen [::]:8448 ssl http2 default_server;
 
  server_name matrix.flowerhouse.at;
</syntaxhighlight>
</syntaxhighlight>


<p>Edit matrix-synapse configuration file</p>
<p>If you want to expose admin api change location</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="json">
nano /etc/matrix-synapse/homeserver.yaml
location: ~ ^(/_matrix|/_synapse)
</syntaxhighlight>
</syntaxhighlight>


<p>Add following lines</p>
<p>Check if federation configuration is correct: https://federationtester.matrix.org/</p>
 
=== .well-known ===
 
<p>NGINX Proxy Manager configuration without exposing admin API</p>
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
suppress_key_server_warning: true
Details:
registration_shared_secret: <SECRET-KEY>
  Scheme: http
# For backfilling (beta)
  Forward Hostname / IP: 192.168.88.19
experimental_features:
  Port: 80
    msc2716_enabled: true
Custom Locations:
</syntaxhighlight>
  location: ~ ^(/_matrix|/_synapse/client)
 
  Scheme: http
<p>Comment following line to make it accessible from outside localhost</p>
  Forward Hostname / IP: 192.168.88.19
<syntaxhighlight lang="console">
  Port: 8008
# bind_addresses: ...
Advanced:
</syntaxhighlight>
  listen 8448 ssl http2 default_server;
  listen [::]:8448 ssl http2 default_server;


<p>Restart matrix-synapse</p>
  server_name matrix.flowerhouse.at;
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>
</syntaxhighlight>
=== Setting up reverse proxy ===
<p>Check federation configuration: https://federationtester.matrix.org/</p>


=== Add User ===
=== Add User ===
Line 141: Line 170:
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
exit
deactivate
</syntaxhighlight>
</syntaxhighlight>


Line 155: Line 184:


<p>General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]</p>
<p>General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]</p>
=== Administration ===
Administration-Tools:
* https://github.com/Awesome-Technologies/synapse-admin (WebUI)
* https://github.com/JOJ0/synadm (Console)
Or make API-Request with curl


== Install Bridges ==
== Install Bridges ==
Line 175: Line 210:


<p>Download binary from https://github.com/mautrix/whatsapp/releases</p>
<p>Download binary from https://github.com/mautrix/whatsapp/releases</p>
<syntaxhighlight lang="console">
wget https://github.com/mautrix/whatsapp/releases/download/v0.5.0/mautrix-whatsapp-amd64
</syntaxhighlight>


<p>Rename binary</p>
<p>Rename binary</p>
Line 270: Line 302:


=== Signal ===
=== Signal ===
==== Install Signald ====
==== Install Bridge ====
<p>Add repository</p>
<p>Create user for mautrix-signal</p>
<syntaxhighlight lang="console">
adduser --system mautrix-signal --home /opt/mautrix-signal
usermod -aG signald mautrix-signal
</syntaxhighlight>
 
<p>Enter user folder</p>
<syntaxhighlight lang="console">
cd /opt/mautrix-signal
</syntaxhighlight>
 
<p>Download binary from https://github.com/mautrix/signal/releases</p>
 
<p>Rename binary</p>
<syntaxhighlight lang="console">
mv mautrix-signal-amd64 mautrix-signal
</syntaxhighlight>
 
==== Create database ====
<p>Open Postgres console</p>
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>
 
<p>Create user for mautrix-whatsapp</p>
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
</syntaxhighlight>
 
<p>Create database for mautrix-whatsapp</p>
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=signal_user signal
</syntaxhighlight>
 
<p>Exit Postgres console</p>
<syntaxhighlight lang="console">
exit
</syntaxhighlight>
 
==== Configuration ====
<p>Copy configuration file and edit...</p>
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>
 
<p>Modify permissions</p>
<syntaxhighlight lang="console">
chmod 755 mautrix-signal
</syntaxhighlight>
 
<p>Generate the appservice registration file</p>
<syntaxhighlight lang="console">
./mautrix-signal -g
</syntaxhighlight>
 
<p>Modify permissions</p>
<syntaxhighlight lang="console">
chmod 555 registration.yaml
</syntaxhighlight>
 
<p>Edit matrix-synapse configuration file</p>
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>
 
<p>To register mautrix-signal add following lines</p>
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
wget -O /usr/share/keyrings/signald-org-archive-keyring.asc https://updates.signald.org/apt-signing-key.asc
app_service_config_files:
echo "deb [signed-by=/usr/share/keyrings/signald-org-archive-keyring.asc] https://updates.signald.org unstable main" | tee /etc/apt/sources.list.d/signald.list
- /opt/mautrix-signal/registration.yaml
apt update
</syntaxhighlight>
 
<p>Restart matrix-synapse</p>
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>
</syntaxhighlight>


<p>Install signald</p>
<p>Check if bridge works</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
apt install signald
./mautrix-signal
</syntaxhighlight>
</syntaxhighlight>


<p>Check if it works correctly</p>
==== systemd service ====
<syntaxhighlight lang="console" line>
<p>Create systemd service file and copy from [https://docs.mau.fi/bridges/python/setup.html?bridge=signal service]</p>
systemctl start signald
<syntaxhighlight lang="console">
systemctl status signald
nano /etc/systemd/system/mautrix-signal.service
</syntaxhighlight>
</syntaxhighlight>


<p>Enable autostart</p>
<p>Apply changes</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
systemctl enable signald
systemctl daemon-reload
</syntaxhighlight>
</syntaxhighlight>


==== Install Bridge ====
<p>Start and check status</p>
<p>Install prerequisites</p>
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
apt install python pip libolm-dev
systemctl start mautrix-signal
pip install virtualenv
systemctl status mautrix-signal
</syntaxhighlight>
 
<p>Enable autostart</p>
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
</syntaxhighlight>
</syntaxhighlight>


<p>Create user for bridge and join signald group</p>
=== Telegram ===
==== Installation ====
<p>Create user for bridge</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
adduser --system mautrix-signal --home /opt/mautrix-signal
adduser --system mautrix-telegram --home /opt/mautrix-telegram
usermod -aG signald mautrix-signal
</syntaxhighlight>
</syntaxhighlight>


<p>Go to directory</p>
<p>Go to directory</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
cd /opt/mautrix-signal
cd /opt/mautrix-telegram
</syntaxhighlight>
</syntaxhighlight>


Line 324: Line 430:
<p>Install signal bridge</p>
<p>Install signal bridge</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
pip install --upgrade mautrix-signal[all]
pip install --upgrade mautrix-telegram[all]
</syntaxhighlight>
</syntaxhighlight>


Line 335: Line 441:
<p>Create user for mautrix-whatsapp</p>
<p>Create user for mautrix-whatsapp</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
createuser --pwprompt telegram_user
</syntaxhighlight>
</syntaxhighlight>


<p>Create database for mautrix-whatsapp</p>
<p>Create database for mautrix-whatsapp</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=signal_user signal
createdb --encoding=UTF8 --locale=C --template=template0 --owner=telegram_user telegram
</syntaxhighlight>
</syntaxhighlight>


Line 356: Line 462:
<p>Generate access file</p>
<p>Generate access file</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
python -m mautrix_signal -g
python -m mautrix_telegram -g
</syntaxhighlight>
 
<p>Set permissions</p>
<syntaxhighlight lang="console">
chown -R mautrix-telegram:root ../mautrix-telegram/
</syntaxhighlight>
 
<p>Edit matrix-synapse configuration file</p>
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>
 
<p>To register WhatsApp add following lines</p>
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-telegram/registration.yaml
</syntaxhighlight>
 
<p>Restart matrix-synapse</p>
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>
 
<p>Check if bridge works</p>
<syntaxhighlight lang="console">
python -m mautrix_telegram
</syntaxhighlight>
 
==== systemd service ====
<p>Create systemd service file and copy from [https://docs.mau.fi/bridges/python/setup.html?bridge=telegram#systemd-service service]</p>
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-telegram.service
</syntaxhighlight>
 
<p>Apply changes</p>
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>
 
<p>Start and check status</p>
<syntaxhighlight lang="console" line>
systemctl start mautrix-telegram
systemctl status mautrix-telegram
</syntaxhighlight>
 
<p>Enable autostart</p>
<syntaxhighlight lang="console">
systemctl enable mautrix-telegram
</syntaxhighlight>
 
=== IRC ===
==== Installation ====
<p>Create user for bridge</p>
<syntaxhighlight lang="console">
adduser --system mautrix-irc --home /opt/mautrix-irc
</syntaxhighlight>
 
<p>Go to directory</p>
<syntaxhighlight lang="console">
cd /opt/mautrix-irc
</syntaxhighlight>
 
<p>Create virtual environment</p>
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>
 
<p>Activate virtual environment</p>
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>
 
<p>Install heisenbridge</p>
<syntaxhighlight lang="console">
pip install --upgrade heisenbridge[all]
</syntaxhighlight>
 
<p>Generate access file</p>
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate
</syntaxhighlight>
</syntaxhighlight>


<p>Set permissions</p>
<p>Set permissions</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
chown -R mautrix-signal:root ../mautrix-signal/
chown -R mautrix-irc:root ../mautrix-irc/
</syntaxhighlight>
</syntaxhighlight>


Line 372: Line 558:
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
app_service_config_files:
app_service_config_files:
- /opt/mautrix-signal/registration.yaml
- /opt/mautrix-irc/registration.yaml
</syntaxhighlight>
</syntaxhighlight>


Line 382: Line 568:
<p>Check if bridge works</p>
<p>Check if bridge works</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
python -m mautrix_signal
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml
</syntaxhighlight>
</syntaxhighlight>
<p>If no .well-known file is configured, startup may take a few minutes</p>


==== systemd service ====
==== systemd service ====
<p>Create systemd service file and copy from [https://docs.mau.fi/bridges/python/setup.html?bridge=signal service]</p>
<p>Create systemd service file and copy from [[mautrix-irc.service]]</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-signal.service
nano /etc/systemd/system/mautrix-irc.service
</syntaxhighlight>
</syntaxhighlight>


Line 398: Line 586:
<p>Start and check status</p>
<p>Start and check status</p>
<syntaxhighlight lang="console" line>
<syntaxhighlight lang="console" line>
systemctl start mautrix-signal
systemctl start mautrix-irc
systemctl status mautrix-signal
systemctl status mautrix-irc
</syntaxhighlight>
</syntaxhighlight>


<p>Enable autostart</p>
<p>Enable autostart</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
systemctl enable mautrix-irc
</syntaxhighlight>
 
==== Configuration ====
<p>This bridge is not configured with an config file but via the bot chat.</p>
<p>The first person chatting with the bot will automatically be set as the admin.</p>
<p>Set mediaurl</p>
<syntaxhighlight lang="console">
MEDIAURL https://matrix.flowerhouse.at
</syntaxhighlight>
 
== Install Element WebClient ==
<p>Install webserver</p>
<syntaxhighlight lang="console">
apt install apache2
</syntaxhighlight>
 
<p>Go to directory</p>
<syntaxhighlight lang="console">
cd /var/www
</syntaxhighlight>
 
<p>Download binary from: https://github.com/vector-im/element-web/releases/</p>
 
<p>Untar and rename</p>
<syntaxhighlight lang="console" line>
tar -xvf element-v1.11.1.tar.gz
mv element-v1.11.1 element
rm element-v1.11.1.tar.gz
</syntaxhighlight>
 
<p>Configure host</p>
<syntaxhighlight lang="console">
nano /etc/apache2/sites-available/element.conf
</syntaxhighlight>
 
<p>Add to file</p>
<syntaxhighlight lang="console" line>
<VirtualHost *:80>
    DocumentRoot /var/www/element
    <Directory /var/www/element>
        AllowOverride All
        Order Allow,Deny
        Allow from All
    </Directory>
 
    ErrorLog /var/log/apache2/element_error.log
</VirtualHost>
</syntaxhighlight>
</syntaxhighlight>


=== Telegram ===
<p>Activate new site</p>
<p></p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
ln -s /etc/apache2/sites-available/element.conf /etc/apache2/sites-enabled/element.conf
</syntaxhighlight>


<p>To access via the IP-Address of the server</p>
<syntaxhighlight lang="console">
rm /etc/apache2/sites-enabled/000-default.conf
</syntaxhighlight>
</syntaxhighlight>


<p></p>
<p>Configure apache to show pretty URL pathes</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
a2enmod rewrite
</syntaxhighlight>


<p>Restart webserver</p>
<syntaxhighlight lang="console">
service apache2 restart
</syntaxhighlight>
</syntaxhighlight>


<p></p>
<p>Create config file</p>
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
cd element
cp config.sample.json config.json
</syntaxhighlight>


<p>Edit config file</p>
<syntaxhighlight lang="console">
nano config.json
</syntaxhighlight>
</syntaxhighlight>

Latest revision as of 15:22, 16 March 2024

Matrix-logo.png

Network

IP: 192.168.88.19
MAC: BE:B1:89:38:28:44
Domain: chat.flowerhouse.at

System

OS: Debian Bullseye
RAM: 4096MB
Cores: 2
Privileged: No

The ChatMatrix-LXC is reachable under 192.168.88.19 which is located in the ServerVLAN.

The subdomain is chat.flowerhouse.at which is handled by the ReverseProxy.

Basic Setup

Be up to date

apt update && apt upgrade

Change timezone

timedatectl set-timezone Europe/Berlin

Change locales to de_AT.UTF-8 for special characters

dpkg-reconfigure locales

Installation

Install required packages

apt install -y lsb-release wget apt-transport-https

Add repository

wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/matrix-org.list
apt update

Install matrix-synapse

apt install matrix-synapse-py3

Check status

systemctl status matrix-synapse

Postgres database

Install required packages

apt install libpq5 postgresql

Open Postgres console

su - postgres

Create user for matrix-synapse

createuser --pwprompt synapse_user

Create database for matrix-synapse

createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

Exit Postgres console

exit

Edit matrix-synapse configuration file

nano /etc/matrix-synapse/homeserver.yaml

Edit the database entry

database:
  name: psycopg2
  args:
    user: synapse_user
    password: <pass>
    database: synapse
    host: localhost
    cp_min: 5
    cp_max: 10

Check if it works

systemctl restart matrix-synapse
systemctl status matrix-synapse

Setting up reverse proxy

NGINX Proxy Manager configuration without exposing admin API

Details:
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 80
Custom Locations:
  location: ~ ^(/_matrix|/_synapse/client)
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 8008
Advanced:
  listen 8448 ssl http2 default_server;
  listen [::]:8448 ssl http2 default_server;

  server_name matrix.flowerhouse.at;

If you want to expose admin api change location

location: ~ ^(/_matrix|/_synapse)

Check if federation configuration is correct: https://federationtester.matrix.org/

.well-known

NGINX Proxy Manager configuration without exposing admin API

Details:
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 80
Custom Locations:
  location: ~ ^(/_matrix|/_synapse/client)
  Scheme: http
  Forward Hostname / IP: 192.168.88.19
  Port: 8008
Advanced:
  listen 8448 ssl http2 default_server;
  listen [::]:8448 ssl http2 default_server;

  server_name matrix.flowerhouse.at;

Add User

register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008

Optional

Configure puppeting

Install required packages

apt install pip git pwgen

Activate synapse virtual enviroment

cd /opt/venvs/matrix-synapse
source ./bin/activate

Install packages

pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
deactivate

Generate shared secret

pwgen -s 128 1

Edit configuration and add configuration

nano /etc/matrix-synapse/homeserver.yaml

General information about puppeting

Administration

Administration-Tools:

Or make API-Request with curl

Install Bridges

ffmpeg is needed to support media files

apt install ffmpeg

WhatsApp

Installation

Create user for mautrix-whatsapp

adduser --system mautrix-whatsapp --home /opt/mautrix-whatsapp

Enter user folder

cd /opt/mautrix-whatsapp

Download binary from https://github.com/mautrix/whatsapp/releases

Rename binary

mv mautrix-whatsapp-amd64 mautrix-whatsapp

Create database

Open Postgres console

su - postgres

Create user for mautrix-whatsapp

createuser --pwprompt whatsapp_user

Create database for mautrix-whatsapp

createdb --encoding=UTF8 --locale=C --template=template0 --owner=whatsapp_user whatsapp

Exit Postgres console

exit

Configuration

Create and paste config file: mautrix-whatsapp-config.yaml

nano config.yaml

Modify permissions

chmod 755 mautrix-whatsapp

Generate the appservice registration file

./mautrix-whatsapp -g

Modify permissions

chmod 555 registration.yaml

Edit matrix-synapse configuration file

nano /etc/matrix-synapse/homeserver.yaml

To register WhatsApp add following lines

app_service_config_files:
- /opt/mautrix-whatsapp/registration.yaml

Restart matrix-synapse

systemctl restart matrix-synapse

Check if bridge works

./mautrix-whatsapp

systemd service

Create systemd service file and copy from service

nano /etc/systemd/system/mautrix-whatsapp.service

Apply changes

systemctl daemon-reload

Start and check status

systemctl start mautrix-whatsapp
systemctl status mautrix-whatsapp

Enable autostart

systemctl enable mautrix-whatsapp

Signal

Install Bridge

Create user for mautrix-signal

adduser --system mautrix-signal --home /opt/mautrix-signal
usermod -aG signald mautrix-signal

Enter user folder

cd /opt/mautrix-signal

Download binary from https://github.com/mautrix/signal/releases

Rename binary

mv mautrix-signal-amd64 mautrix-signal

Create database

Open Postgres console

su - postgres

Create user for mautrix-whatsapp

createuser --pwprompt signal_user

Create database for mautrix-whatsapp

createdb --encoding=UTF8 --locale=C --template=template0 --owner=signal_user signal

Exit Postgres console

exit

Configuration

Copy configuration file and edit...

cp example-config.yaml config.yaml

Modify permissions

chmod 755 mautrix-signal

Generate the appservice registration file

./mautrix-signal -g

Modify permissions

chmod 555 registration.yaml

Edit matrix-synapse configuration file

nano /etc/matrix-synapse/homeserver.yaml

To register mautrix-signal add following lines

app_service_config_files:
- /opt/mautrix-signal/registration.yaml

Restart matrix-synapse

systemctl restart matrix-synapse

Check if bridge works

./mautrix-signal

systemd service

Create systemd service file and copy from service

nano /etc/systemd/system/mautrix-signal.service

Apply changes

systemctl daemon-reload

Start and check status

systemctl start mautrix-signal
systemctl status mautrix-signal

Enable autostart

systemctl enable mautrix-signal

Telegram

Installation

Create user for bridge

adduser --system mautrix-telegram --home /opt/mautrix-telegram

Go to directory

cd /opt/mautrix-telegram

Create virtual environment

virtualenv -p /usr/bin/python3 .

Activate virtual environment

source ./bin/activate

Install signal bridge

pip install --upgrade mautrix-telegram[all]

Create database

Open Postgres console

su - postgres

Create user for mautrix-whatsapp

createuser --pwprompt telegram_user

Create database for mautrix-whatsapp

createdb --encoding=UTF8 --locale=C --template=template0 --owner=telegram_user telegram

Exit Postgres console

exit

Configuration

Copy configuration file and edit...

cp example-config.yaml config.yaml

Generate access file

python -m mautrix_telegram -g

Set permissions

chown -R mautrix-telegram:root ../mautrix-telegram/

Edit matrix-synapse configuration file

nano /etc/matrix-synapse/homeserver.yaml

To register WhatsApp add following lines

app_service_config_files:
- /opt/mautrix-telegram/registration.yaml

Restart matrix-synapse

systemctl restart matrix-synapse

Check if bridge works

python -m mautrix_telegram

systemd service

Create systemd service file and copy from service

nano /etc/systemd/system/mautrix-telegram.service

Apply changes

systemctl daemon-reload

Start and check status

systemctl start mautrix-telegram
systemctl status mautrix-telegram

Enable autostart

systemctl enable mautrix-telegram

IRC

Installation

Create user for bridge

adduser --system mautrix-irc --home /opt/mautrix-irc

Go to directory

cd /opt/mautrix-irc

Create virtual environment

virtualenv -p /usr/bin/python3 .

Activate virtual environment

source ./bin/activate

Install heisenbridge

pip install --upgrade heisenbridge[all]

Generate access file

python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate

Set permissions

chown -R mautrix-irc:root ../mautrix-irc/

Edit matrix-synapse configuration file

nano /etc/matrix-synapse/homeserver.yaml

To register WhatsApp add following lines

app_service_config_files:
- /opt/mautrix-irc/registration.yaml

Restart matrix-synapse

systemctl restart matrix-synapse

Check if bridge works

python -m heisenbridge -c /opt/mautrix-irc/registration.yaml

If no .well-known file is configured, startup may take a few minutes

systemd service

Create systemd service file and copy from mautrix-irc.service

nano /etc/systemd/system/mautrix-irc.service

Apply changes

systemctl daemon-reload

Start and check status

systemctl start mautrix-irc
systemctl status mautrix-irc

Enable autostart

systemctl enable mautrix-irc

Configuration

This bridge is not configured with an config file but via the bot chat.

The first person chatting with the bot will automatically be set as the admin.

Set mediaurl

MEDIAURL https://matrix.flowerhouse.at

Install Element WebClient

Install webserver

apt install apache2

Go to directory

cd /var/www

Download binary from: https://github.com/vector-im/element-web/releases/

Untar and rename

tar -xvf element-v1.11.1.tar.gz
mv element-v1.11.1 element
rm element-v1.11.1.tar.gz

Configure host

nano /etc/apache2/sites-available/element.conf

Add to file

<VirtualHost *:80>
    DocumentRoot /var/www/element
    <Directory /var/www/element>
        AllowOverride All
        Order Allow,Deny
        Allow from All
    </Directory>

    ErrorLog /var/log/apache2/element_error.log
</VirtualHost>

Activate new site

ln -s /etc/apache2/sites-available/element.conf /etc/apache2/sites-enabled/element.conf

To access via the IP-Address of the server

rm /etc/apache2/sites-enabled/000-default.conf

Configure apache to show pretty URL pathes

a2enmod rewrite

Restart webserver

service apache2 restart

Create config file

cd element
cp config.sample.json config.json

Edit config file

nano config.json
Retrieved from "https://wiki.flowerhouse.at/index.php?title=ChatMatrix&oldid=1038"