{{ContainerInfo
|image = Matrix-logo.png
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|MAC = BE:B1:89:38:28:44
|IP = 192.168.88.19
|Privileged = No
|OS = Debian Bullseye
|RAM = 4096MB
|Cores = 2
}}

The ChatMatrix-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.19</syntaxhighlight> which is located in the ServerVLAN.
The subdomain is [https://chat.flowerhouse.at chat.flowerhouse.at] which is handled by the [[ReverseProxy]].
__TOC__
== Basic Setup ==

Be up to date
<syntaxhighlight lang="console">
apt update && apt upgrade
</syntaxhighlight>

Change timezone
<syntaxhighlight lang="console">
timedatectl set-timezone Europe/Berlin
</syntaxhighlight>

Change locales to de_AT.UTF-8 for special characters
<syntaxhighlight lang="console">
dpkg-reconfigure locales
</syntaxhighlight>

=== Installation ===
Install required packages
<syntaxhighlight lang="console">
apt install -y lsb-release wget apt-transport-https
</syntaxhighlight>

Add repository
<syntaxhighlight lang="console" line>
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
</syntaxhighlight>

Install matrix-synapse
<syntaxhighlight lang="console">
apt install matrix-synapse-py3
</syntaxhighlight>

Check status
<syntaxhighlight lang="console">
systemctl status matrix-synapse
</syntaxhighlight>

=== Postgres database ===
Install required packages
<syntaxhighlight lang="console">
apt install libpq5 postgresql
</syntaxhighlight>

Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for matrix-synapse
<syntaxhighlight lang="console">
createuser --pwprompt synapse_user
</syntaxhighlight>

Create database for matrix-synapse
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

Edit the database entry
<syntaxhighlight lang="console" line>
database:
name: psycopg2
args:
user: synapse_user
password: <pass>
database: synapse
host: localhost
cp_min: 5
cp_max: 10
</syntaxhighlight>

Check if it works
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
systemctl status matrix-synapse
</syntaxhighlight>

=== Setting up reverse proxy ===
NGINX Proxy Manager configuration without exposing admin API
<syntaxhighlight lang="console" line>
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>

If you want to expose admin api change location
<syntaxhighlight lang="json">
location: ~ ^(/_matrix|/_synapse)
</syntaxhighlight>

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

=== .well-known ===

NGINX Proxy Manager configuration without exposing admin API
<syntaxhighlight lang="console" line>
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>

=== Add User ===
<syntaxhighlight lang="console">
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008
</syntaxhighlight>

=== Optional ===
==== Configure puppeting ====
Install required packages
<syntaxhighlight lang="console">
apt install pip git pwgen
</syntaxhighlight>

Activate synapse virtual enviroment
<syntaxhighlight lang="console" line>
cd /opt/venvs/matrix-synapse
source ./bin/activate
</syntaxhighlight>

Install packages
<syntaxhighlight lang="console" line>
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
deactivate
</syntaxhighlight>

Generate shared secret
<syntaxhighlight lang="console">
pwgen -s 128 1
</syntaxhighlight>

Edit configuration and add [https://github.com/devture/matrix-synapse-shared-secret-auth#configuring configuration]
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]

=== 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 ==
ffmpeg is needed to support media files
<syntaxhighlight lang="console">
apt install ffmpeg
</syntaxhighlight>

=== WhatsApp ===
==== Installation ====
Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
adduser --system mautrix-whatsapp --home /opt/mautrix-whatsapp
</syntaxhighlight>

Enter user folder
<syntaxhighlight lang="console" line>
cd /opt/mautrix-whatsapp
</syntaxhighlight>

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

Rename binary
<syntaxhighlight lang="console">
mv mautrix-whatsapp-amd64 mautrix-whatsapp
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt whatsapp_user
</syntaxhighlight>

Create database for mautrix-whatsapp
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=whatsapp_user whatsapp
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Create and paste config file: [[mautrix-whatsapp-config.yaml]]
<syntaxhighlight lang="console">
nano config.yaml
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 755 mautrix-whatsapp
</syntaxhighlight>

Generate the appservice registration file
<syntaxhighlight lang="console">
./mautrix-whatsapp -g
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 555 registration.yaml
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-whatsapp/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
./mautrix-whatsapp
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-whatsapp
systemctl status mautrix-whatsapp
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-whatsapp
</syntaxhighlight>

=== Signal ===
==== Install Signald ====
Add repository
<syntaxhighlight lang="console" line>
wget -O /usr/share/keyrings/signald-org-archive-keyring.asc https://updates.signald.org/apt-signing-key.asc
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
apt update
</syntaxhighlight>

Install signald
<syntaxhighlight lang="console">
apt install signald
</syntaxhighlight>

Check if it works correctly
<syntaxhighlight lang="console" line>
systemctl start signald
systemctl status signald
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable signald
</syntaxhighlight>

==== Install Bridge ====
Install prerequisites
<syntaxhighlight lang="console" line>
apt install python pip libolm-dev
pip install virtualenv
</syntaxhighlight>

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

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install signal bridge
<syntaxhighlight lang="console">
pip install --upgrade mautrix-signal[all]
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_signal -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-signal/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_signal
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-signal
systemctl status mautrix-signal
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
</syntaxhighlight>

=== Telegram ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-telegram --home /opt/mautrix-telegram
</syntaxhighlight>

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

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

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt telegram_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_telegram -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-telegram/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_telegram
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-telegram
systemctl status mautrix-telegram
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-telegram
</syntaxhighlight>

=== IRC ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-irc --home /opt/mautrix-irc
</syntaxhighlight>

Go to directory
<syntaxhighlight lang="console">
cd /opt/mautrix-irc
</syntaxhighlight>

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install heisenbridge
<syntaxhighlight lang="console">
pip install --upgrade heisenbridge[all]
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

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]]
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-irc.service
</syntaxhighlight>

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-irc
systemctl status mautrix-irc
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-irc
</syntaxhighlight>

==== 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
<syntaxhighlight lang="console">
MEDIAURL https://matrix.flowerhouse.at
</syntaxhighlight>

== Install Element WebClient ==
Install webserver
<syntaxhighlight lang="console">
apt install apache2
</syntaxhighlight>

Go to directory
<syntaxhighlight lang="console">
cd /var/www
</syntaxhighlight>

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

Untar and rename
<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>

Configure host
<syntaxhighlight lang="console">
nano /etc/apache2/sites-available/element.conf
</syntaxhighlight>

Add to file
<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>

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

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

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

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

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

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

PartDB

2023-02-11T20:54:42Z

Tropaion: /* New version */

{{ContainerInfo
|Domain = [https://parts.flowerhouse.at parts.flowerhouse.at]
|IP = 192.168.88.16
|MAC = 32:22:DA:F2:39:1B
|Privileged = No
|OS = Debian Bullseye
|RAM = 512MB
|Cores = 1
}}

The PartDB-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.16</syntaxhighlight> which is located in the ServerVLAN.
The subdomain is [https://parts.flowerhouse.at parts.flowerhouse.at] which is handled by the [[ReverseProxy]].
__TOC__
== Old version ==
Install the required packages:
<syntaxhighlight lang="console">
apt install git zip apache2 php php-mysql php-curl libapache2-mod-php php-opcache php-gettext
</syntaxhighlight>

Configure locales:
<syntaxhighlight lang="console">
dpkg-reconfigure locales
</syntaxhighlight>

=== Configure Apache ===
Open the following file:
<syntaxhighlight lang="console">
nano /etc/apache2/apache2.conf
</syntaxhighlight>

And change this part:
<syntaxhighlight lang="console" line>
<Directory /var/www/>
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>
</syntaxhighlight>

to this:
<syntaxhighlight lang="console" line>
<Directory /var/www/>
Options -Indexes
AllowOverride All
Require all granted
</Directory>
</syntaxhighlight>

Restart the apache service:
<syntaxhighlight lang="console">
systemctl restart apache2
</syntaxhighlight>

=== Configure PHP ===
Edit ''php.ini'':
<syntaxhighlight lang="console">
nano /etc/php/7.3/apache2/php.ini
</syntaxhighlight>

Change the following settings:
<syntaxhighlight lang="console">
memory_limit = 128M
upload_max_filesize = 100M
post_max_size = 100M
</syntaxhighlight>

=== PartDB ===
Download and unpack:
<syntaxhighlight lang="console" line>
wget -O part-db.tar.gz https://github.com/jbtronics/Part-DB/archive/master.tar.gz
tar -xzf part-db.tar.gz -C /var/www
rm part-db.tar.gz
</syntaxhighlight>

Change folder name to root directory:
<syntaxhighlight lang="console" line>
cd /var/www
rm -r html
mv Part-DB-master html
</syntaxhighlight>

Set ownership:
<syntaxhighlight lang="console">
chown -R www-data:www-data html
</syntaxhighlight>

Generate composer files:
<syntaxhighlight lang="console" line>
cd /var/www/html
php composer.phar install -o --no-dev
</syntaxhighlight>
e]smoFA14yF1!.6A

== New version ==
[https://docs.part-db.de/installation/installation%20guide-debian.html Installation Guide]

[https://docs.part-db.de/installation/installation_guide-debian.html#update-part-db Update Guide]

== Sources ==
* [https://github.com/Part-DB/Part-DB/wiki/EN%3A-Requirements Requirements]
* [https://github.com/Part-DB/Part-DB/wiki/EN%3A-Installation Install PartDB]

2022-08-19T14:02:46Z

Tropaion: /* Setting up reverse proxy */

{{ContainerInfo
|image = Matrix-logo.png
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|MAC = BE:B1:89:38:28:44
|IP = 192.168.88.19
|Privileged = No
|OS = Debian Bullseye
|RAM = 4096MB
|Cores = 2
}}

The ChatMatrix-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.19</syntaxhighlight> which is located in the ServerVLAN.
The subdomain is [https://chat.flowerhouse.at chat.flowerhouse.at] which is handled by the [[ReverseProxy]].
__TOC__
== Basic Setup ==

Be up to date
<syntaxhighlight lang="console">
apt update && apt upgrade
</syntaxhighlight>

Change timezone
<syntaxhighlight lang="console">
timedatectl set-timezone Europe/Berlin
</syntaxhighlight>
=== Installation ===
Install required packages
<syntaxhighlight lang="console">
apt install -y lsb-release wget apt-transport-https
</syntaxhighlight>

Add repository
<syntaxhighlight lang="console" line>
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
</syntaxhighlight>

Install matrix-synapse
<syntaxhighlight lang="console">
apt install matrix-synapse-py3
</syntaxhighlight>

Check status
<syntaxhighlight lang="console">
systemctl status matrix-synapse
</syntaxhighlight>

=== Postgres database ===
Install required packages
<syntaxhighlight lang="console">
apt install libpq5 postgresql
</syntaxhighlight>

Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for matrix-synapse
<syntaxhighlight lang="console">
createuser --pwprompt synapse_user
</syntaxhighlight>

Create database for matrix-synapse
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

Edit the database entry
<syntaxhighlight lang="console" line>
database:
name: psycopg2
args:
user: synapse_user
password: <pass>
database: synapse
host: localhost
cp_min: 5
cp_max: 10
</syntaxhighlight>

Check if it works
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
systemctl status matrix-synapse
</syntaxhighlight>

=== Setting up reverse proxy ===
NGINX Proxy Manager configuration without exposing admin API
<syntaxhighlight lang="console" line>
Details:
Scheme: http
Forward Hostname / IP: 192.168.88.19
Port: 80
Custom Locations:
location: ~ ^(/_matrix|/_synapse)
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>

If you want to expose admin api, change custom location to
<syntaxhighlight lang="json">
~ ^(/_matrix|/_synapse)
</syntaxhighlight>

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

=== .well-known ===

=== Add User ===
<syntaxhighlight lang="console">
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008
</syntaxhighlight>

=== Optional ===
==== Configure puppeting ====
Install required packages
<syntaxhighlight lang="console">
apt install pip git pwgen
</syntaxhighlight>

Activate synapse virtual enviroment
<syntaxhighlight lang="console" line>
cd /opt/venvs/matrix-synapse
source ./bin/activate
</syntaxhighlight>

Install packages
<syntaxhighlight lang="console" line>
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
deactivate
</syntaxhighlight>

Generate shared secret
<syntaxhighlight lang="console">
pwgen -s 128 1
</syntaxhighlight>

Edit configuration and add [https://github.com/devture/matrix-synapse-shared-secret-auth#configuring configuration]
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]

=== 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 ==
ffmpeg is needed to support media files
<syntaxhighlight lang="console">
apt install ffmpeg
</syntaxhighlight>

=== WhatsApp ===
==== Installation ====
Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
adduser --system mautrix-whatsapp --home /opt/mautrix-whatsapp
</syntaxhighlight>

Enter user folder
<syntaxhighlight lang="console" line>
cd /opt/mautrix-whatsapp
</syntaxhighlight>

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

Rename binary
<syntaxhighlight lang="console">
mv mautrix-whatsapp-amd64 mautrix-whatsapp
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt whatsapp_user
</syntaxhighlight>

Create database for mautrix-whatsapp
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=whatsapp_user whatsapp
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Create and paste config file: [[mautrix-whatsapp-config.yaml]]
<syntaxhighlight lang="console">
nano config.yaml
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 755 mautrix-whatsapp
</syntaxhighlight>

Generate the appservice registration file
<syntaxhighlight lang="console">
./mautrix-whatsapp -g
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 555 registration.yaml
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-whatsapp/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
./mautrix-whatsapp
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-whatsapp
systemctl status mautrix-whatsapp
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-whatsapp
</syntaxhighlight>

=== Signal ===
==== Install Signald ====
Add repository
<syntaxhighlight lang="console" line>
wget -O /usr/share/keyrings/signald-org-archive-keyring.asc https://updates.signald.org/apt-signing-key.asc
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
apt update
</syntaxhighlight>

Install signald
<syntaxhighlight lang="console">
apt install signald
</syntaxhighlight>

Check if it works correctly
<syntaxhighlight lang="console" line>
systemctl start signald
systemctl status signald
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable signald
</syntaxhighlight>

==== Install Bridge ====
Install prerequisites
<syntaxhighlight lang="console" line>
apt install python pip libolm-dev
pip install virtualenv
</syntaxhighlight>

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

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install signal bridge
<syntaxhighlight lang="console">
pip install --upgrade mautrix-signal[all]
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_signal -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-signal/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_signal
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-signal
systemctl status mautrix-signal
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
</syntaxhighlight>

=== Telegram ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-telegram --home /opt/mautrix-telegram
</syntaxhighlight>

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

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

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt telegram_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_telegram -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-telegram/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_telegram
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-telegram
systemctl status mautrix-telegram
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-telegram
</syntaxhighlight>

=== IRC ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-irc --home /opt/mautrix-irc
</syntaxhighlight>

Go to directory
<syntaxhighlight lang="console">
cd /opt/mautrix-irc
</syntaxhighlight>

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install heisenbridge
<syntaxhighlight lang="console">
pip install heisenbridge
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

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]]
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-irc.service
</syntaxhighlight>

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-irc
systemctl status mautrix-irc
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-irc
</syntaxhighlight>

==== 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
<syntaxhighlight lang="console">
MEDIAURL chat.flowerhouse.at
</syntaxhighlight>

ChatMatrix

2022-08-19T13:55:55Z

Tropaion: /* Setting up reverse proxy */

{{ContainerInfo
|image = Matrix-logo.png
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|MAC = BE:B1:89:38:28:44
|IP = 192.168.88.19
|Privileged = No
|OS = Debian Bullseye
|RAM = 4096MB
|Cores = 2
}}

The ChatMatrix-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.19</syntaxhighlight> which is located in the ServerVLAN.
The subdomain is [https://chat.flowerhouse.at chat.flowerhouse.at] which is handled by the [[ReverseProxy]].
__TOC__
== Basic Setup ==

Be up to date
<syntaxhighlight lang="console">
apt update && apt upgrade
</syntaxhighlight>

Change timezone
<syntaxhighlight lang="console">
timedatectl set-timezone Europe/Berlin
</syntaxhighlight>
=== Installation ===
Install required packages
<syntaxhighlight lang="console">
apt install -y lsb-release wget apt-transport-https
</syntaxhighlight>

Add repository
<syntaxhighlight lang="console" line>
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
</syntaxhighlight>

Install matrix-synapse
<syntaxhighlight lang="console">
apt install matrix-synapse-py3
</syntaxhighlight>

Check status
<syntaxhighlight lang="console">
systemctl status matrix-synapse
</syntaxhighlight>

=== Postgres database ===
Install required packages
<syntaxhighlight lang="console">
apt install libpq5 postgresql
</syntaxhighlight>

Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for matrix-synapse
<syntaxhighlight lang="console">
createuser --pwprompt synapse_user
</syntaxhighlight>

Create database for matrix-synapse
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

Edit the database entry
<syntaxhighlight lang="console" line>
database:
name: psycopg2
args:
user: synapse_user
password: <pass>
database: synapse
host: localhost
cp_min: 5
cp_max: 10
</syntaxhighlight>

Check if it works
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
systemctl status matrix-synapse
</syntaxhighlight>

=== Setting up reverse proxy ===
NGINX Proxy Manager configuration without exposing admin API
<syntaxhighlight lang="json" line>
{
"id": 3,
"created_on": "2022-07-28 21:08:35",
"modified_on": "2022-08-19 01:23:10",
"owner_user_id": 1,
"domain_names": [
"matrix.flowerhouse.at"
],
"forward_host": "192.168.88.19",
"forward_port": 80,
"access_list_id": 0,
"certificate_id": 25,
"ssl_forced": true,
"caching_enabled": true,
"block_exploits": true,
"advanced_config": "listen 8448 ssl http2 default_server;\r\nlisten [::]:8448 ssl http2 default_server;\r\n\r\nserver_name matrix.flowerhouse.at;",
"meta": {
"letsencrypt_agree": false,
"dns_challenge": false
},
"allow_websocket_upgrade": true,
"http2_support": true,
"forward_scheme": "http",
"enabled": 1,
"locations": [
{
"path": "~ ^(/_matrix|/_synapse/client)",
"advanced_config": "proxy_set_header X-Forwarded-For $remote_addr;\nproxy_set_header X-Forwarded-Proto $scheme;\nproxy_set_header Host $host;\n\n# Nginx by default only allows file uploads up to 1M in size\nclient_max_body_size 50M;",
"forward_scheme": "http",
"forward_host": "192.168.88.19",
"forward_port": 8008
}
],
"hsts_enabled": true,
"hsts_subdomains": false
}
</syntaxhighlight>

If you want to expose admin api, change custom location to
<syntaxhighlight lang="json">
~ ^(/_matrix|/_synapse)
</syntaxhighlight>

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

=== .well-known ===

=== Add User ===
<syntaxhighlight lang="console">
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008
</syntaxhighlight>

=== Optional ===
==== Configure puppeting ====
Install required packages
<syntaxhighlight lang="console">
apt install pip git pwgen
</syntaxhighlight>

Activate synapse virtual enviroment
<syntaxhighlight lang="console" line>
cd /opt/venvs/matrix-synapse
source ./bin/activate
</syntaxhighlight>

Install packages
<syntaxhighlight lang="console" line>
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
deactivate
</syntaxhighlight>

Generate shared secret
<syntaxhighlight lang="console">
pwgen -s 128 1
</syntaxhighlight>

Edit configuration and add [https://github.com/devture/matrix-synapse-shared-secret-auth#configuring configuration]
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]

=== 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 ==
ffmpeg is needed to support media files
<syntaxhighlight lang="console">
apt install ffmpeg
</syntaxhighlight>

=== WhatsApp ===
==== Installation ====
Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
adduser --system mautrix-whatsapp --home /opt/mautrix-whatsapp
</syntaxhighlight>

Enter user folder
<syntaxhighlight lang="console" line>
cd /opt/mautrix-whatsapp
</syntaxhighlight>

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

Rename binary
<syntaxhighlight lang="console">
mv mautrix-whatsapp-amd64 mautrix-whatsapp
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt whatsapp_user
</syntaxhighlight>

Create database for mautrix-whatsapp
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=whatsapp_user whatsapp
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Create and paste config file: [[mautrix-whatsapp-config.yaml]]
<syntaxhighlight lang="console">
nano config.yaml
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 755 mautrix-whatsapp
</syntaxhighlight>

Generate the appservice registration file
<syntaxhighlight lang="console">
./mautrix-whatsapp -g
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 555 registration.yaml
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-whatsapp/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
./mautrix-whatsapp
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-whatsapp
systemctl status mautrix-whatsapp
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-whatsapp
</syntaxhighlight>

=== Signal ===
==== Install Signald ====
Add repository
<syntaxhighlight lang="console" line>
wget -O /usr/share/keyrings/signald-org-archive-keyring.asc https://updates.signald.org/apt-signing-key.asc
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
apt update
</syntaxhighlight>

Install signald
<syntaxhighlight lang="console">
apt install signald
</syntaxhighlight>

Check if it works correctly
<syntaxhighlight lang="console" line>
systemctl start signald
systemctl status signald
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable signald
</syntaxhighlight>

==== Install Bridge ====
Install prerequisites
<syntaxhighlight lang="console" line>
apt install python pip libolm-dev
pip install virtualenv
</syntaxhighlight>

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

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install signal bridge
<syntaxhighlight lang="console">
pip install --upgrade mautrix-signal[all]
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_signal -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-signal/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_signal
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-signal
systemctl status mautrix-signal
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
</syntaxhighlight>

=== Telegram ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-telegram --home /opt/mautrix-telegram
</syntaxhighlight>

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

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

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt telegram_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_telegram -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-telegram/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_telegram
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-telegram
systemctl status mautrix-telegram
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-telegram
</syntaxhighlight>

=== IRC ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-irc --home /opt/mautrix-irc
</syntaxhighlight>

Go to directory
<syntaxhighlight lang="console">
cd /opt/mautrix-irc
</syntaxhighlight>

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install heisenbridge
<syntaxhighlight lang="console">
pip install heisenbridge
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

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]]
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-irc.service
</syntaxhighlight>

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-irc
systemctl status mautrix-irc
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-irc
</syntaxhighlight>

==== 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
<syntaxhighlight lang="console">
MEDIAURL chat.flowerhouse.at
</syntaxhighlight>

ChatMatrix

2022-08-19T13:55:04Z

Tropaion: /* Setting up reverse proxy */

{{ContainerInfo
|image = Matrix-logo.png
|Domain = [https://chat.flowerhouse.at chat.flowerhouse.at]
|MAC = BE:B1:89:38:28:44
|IP = 192.168.88.19
|Privileged = No
|OS = Debian Bullseye
|RAM = 4096MB
|Cores = 2
}}

The ChatMatrix-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.19</syntaxhighlight> which is located in the ServerVLAN.
The subdomain is [https://chat.flowerhouse.at chat.flowerhouse.at] which is handled by the [[ReverseProxy]].
__TOC__
== Basic Setup ==

Be up to date
<syntaxhighlight lang="console">
apt update && apt upgrade
</syntaxhighlight>

Change timezone
<syntaxhighlight lang="console">
timedatectl set-timezone Europe/Berlin
</syntaxhighlight>
=== Installation ===
Install required packages
<syntaxhighlight lang="console">
apt install -y lsb-release wget apt-transport-https
</syntaxhighlight>

Add repository
<syntaxhighlight lang="console" line>
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
</syntaxhighlight>

Install matrix-synapse
<syntaxhighlight lang="console">
apt install matrix-synapse-py3
</syntaxhighlight>

Check status
<syntaxhighlight lang="console">
systemctl status matrix-synapse
</syntaxhighlight>

=== Postgres database ===
Install required packages
<syntaxhighlight lang="console">
apt install libpq5 postgresql
</syntaxhighlight>

Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for matrix-synapse
<syntaxhighlight lang="console">
createuser --pwprompt synapse_user
</syntaxhighlight>

Create database for matrix-synapse
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

Edit the database entry
<syntaxhighlight lang="console" line>
database:
name: psycopg2
args:
user: synapse_user
password: <pass>
database: synapse
host: localhost
cp_min: 5
cp_max: 10
</syntaxhighlight>

Check if it works
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
systemctl status matrix-synapse
</syntaxhighlight>

=== Setting up reverse proxy ===
NGINX Proxy Manager configuration without exposing admin API
<syntaxhighlight lang="json" line>
{
"id": 3,
"created_on": "2022-07-28 21:08:35",
"modified_on": "2022-08-19 01:23:10",
"owner_user_id": 1,
"domain_names": [
"matrix.flowerhouse.at"
],
"forward_host": "192.168.88.19",
"forward_port": 80,
"access_list_id": 0,
"certificate_id": 25,
"ssl_forced": true,
"caching_enabled": true,
"block_exploits": true,
"advanced_config": "listen 8448 ssl http2 default_server;\r\nlisten [::]:8448 ssl http2 default_server;\r\n\r\nserver_name matrix.flowerhouse.at;",
"meta": {
"letsencrypt_agree": false,
"dns_challenge": false
},
"allow_websocket_upgrade": true,
"http2_support": true,
"forward_scheme": "http",
"enabled": 1,
"locations": [
{
"path": "~ ^(/_matrix|/_synapse/client)",
"advanced_config": "proxy_set_header X-Forwarded-For $remote_addr;\nproxy_set_header X-Forwarded-Proto $scheme;\nproxy_set_header Host $host;\n\n# Nginx by default only allows file uploads up to 1M in size\nclient_max_body_size 50M;",
"forward_scheme": "http",
"forward_host": "192.168.88.19",
"forward_port": 8008
}
],
"hsts_enabled": true,
"hsts_subdomains": false
}
</syntaxhighlight>

If you want to expose admin api, change custom location to
<syntaxhighlight lang="json">
~ ^(/_matrix|/_synapse)
</syntaxhighlight>

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

=== Add User ===
<syntaxhighlight lang="console">
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008
</syntaxhighlight>

=== Optional ===
==== Configure puppeting ====
Install required packages
<syntaxhighlight lang="console">
apt install pip git pwgen
</syntaxhighlight>

Activate synapse virtual enviroment
<syntaxhighlight lang="console" line>
cd /opt/venvs/matrix-synapse
source ./bin/activate
</syntaxhighlight>

Install packages
<syntaxhighlight lang="console" line>
pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth
deactivate
</syntaxhighlight>

Generate shared secret
<syntaxhighlight lang="console">
pwgen -s 128 1
</syntaxhighlight>

Edit configuration and add [https://github.com/devture/matrix-synapse-shared-secret-auth#configuring configuration]
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

General information about [https://docs.mau.fi/bridges/general/double-puppeting.html puppeting]

=== 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 ==
ffmpeg is needed to support media files
<syntaxhighlight lang="console">
apt install ffmpeg
</syntaxhighlight>

=== WhatsApp ===
==== Installation ====
Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
adduser --system mautrix-whatsapp --home /opt/mautrix-whatsapp
</syntaxhighlight>

Enter user folder
<syntaxhighlight lang="console" line>
cd /opt/mautrix-whatsapp
</syntaxhighlight>

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

Rename binary
<syntaxhighlight lang="console">
mv mautrix-whatsapp-amd64 mautrix-whatsapp
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt whatsapp_user
</syntaxhighlight>

Create database for mautrix-whatsapp
<syntaxhighlight lang="console">
createdb --encoding=UTF8 --locale=C --template=template0 --owner=whatsapp_user whatsapp
</syntaxhighlight>

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Create and paste config file: [[mautrix-whatsapp-config.yaml]]
<syntaxhighlight lang="console">
nano config.yaml
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 755 mautrix-whatsapp
</syntaxhighlight>

Generate the appservice registration file
<syntaxhighlight lang="console">
./mautrix-whatsapp -g
</syntaxhighlight>

Modify permissions
<syntaxhighlight lang="console">
chmod 555 registration.yaml
</syntaxhighlight>

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-whatsapp/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
./mautrix-whatsapp
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-whatsapp
systemctl status mautrix-whatsapp
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-whatsapp
</syntaxhighlight>

=== Signal ===
==== Install Signald ====
Add repository
<syntaxhighlight lang="console" line>
wget -O /usr/share/keyrings/signald-org-archive-keyring.asc https://updates.signald.org/apt-signing-key.asc
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
apt update
</syntaxhighlight>

Install signald
<syntaxhighlight lang="console">
apt install signald
</syntaxhighlight>

Check if it works correctly
<syntaxhighlight lang="console" line>
systemctl start signald
systemctl status signald
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable signald
</syntaxhighlight>

==== Install Bridge ====
Install prerequisites
<syntaxhighlight lang="console" line>
apt install python pip libolm-dev
pip install virtualenv
</syntaxhighlight>

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

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install signal bridge
<syntaxhighlight lang="console">
pip install --upgrade mautrix-signal[all]
</syntaxhighlight>

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt signal_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_signal -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-signal/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_signal
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-signal
systemctl status mautrix-signal
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-signal
</syntaxhighlight>

=== Telegram ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-telegram --home /opt/mautrix-telegram
</syntaxhighlight>

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

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

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

==== Create database ====
Open Postgres console
<syntaxhighlight lang="console">
su - postgres
</syntaxhighlight>

Create user for mautrix-whatsapp
<syntaxhighlight lang="console">
createuser --pwprompt telegram_user
</syntaxhighlight>

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

Exit Postgres console
<syntaxhighlight lang="console">
exit
</syntaxhighlight>

==== Configuration ====
Copy configuration file and edit...
<syntaxhighlight lang="console">
cp example-config.yaml config.yaml
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m mautrix_telegram -g
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-telegram/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m mautrix_telegram
</syntaxhighlight>

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

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-telegram
systemctl status mautrix-telegram
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-telegram
</syntaxhighlight>

=== IRC ===
==== Installation ====
Create user for bridge
<syntaxhighlight lang="console">
adduser --system mautrix-irc --home /opt/mautrix-irc
</syntaxhighlight>

Go to directory
<syntaxhighlight lang="console">
cd /opt/mautrix-irc
</syntaxhighlight>

Create virtual environment
<syntaxhighlight lang="console">
virtualenv -p /usr/bin/python3 .
</syntaxhighlight>

Activate virtual environment
<syntaxhighlight lang="console">
source ./bin/activate
</syntaxhighlight>

Install heisenbridge
<syntaxhighlight lang="console">
pip install heisenbridge
</syntaxhighlight>

Generate access file
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml --generate
</syntaxhighlight>

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

Edit matrix-synapse configuration file
<syntaxhighlight lang="console">
nano /etc/matrix-synapse/homeserver.yaml
</syntaxhighlight>

To register WhatsApp add following lines
<syntaxhighlight lang="console" line>
app_service_config_files:
- /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

Restart matrix-synapse
<syntaxhighlight lang="console">
systemctl restart matrix-synapse
</syntaxhighlight>

Check if bridge works
<syntaxhighlight lang="console">
python -m heisenbridge -c /opt/mautrix-irc/registration.yaml
</syntaxhighlight>

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]]
<syntaxhighlight lang="console">
nano /etc/systemd/system/mautrix-irc.service
</syntaxhighlight>

Apply changes
<syntaxhighlight lang="console">
systemctl daemon-reload
</syntaxhighlight>

Start and check status
<syntaxhighlight lang="console" line>
systemctl start mautrix-irc
systemctl status mautrix-irc
</syntaxhighlight>

Enable autostart
<syntaxhighlight lang="console">
systemctl enable mautrix-irc
</syntaxhighlight>

==== 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
<syntaxhighlight lang="console">
MEDIAURL chat.flowerhouse.at
</syntaxhighlight>