2024-11-04 15:03:22 +01:00
|
|
|
---
|
|
|
|
|
gitea: none
|
|
|
|
|
include_toc: true
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Installation and configuration of Synapse
|
|
|
|
|
|
2024-11-04 15:13:18 +01:00
|
|
|
Mind you: this an installation on Debian Linux (at least for now).
|
|
|
|
|
|
|
|
|
|
Start by installing the latest Synapse server, see the [upstream
|
|
|
|
|
documentation](https://element-hq.github.io/synapse/latest/setup/installation.html).
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
apt install -y lsb-release wget apt-transport-https build-essential python3-dev libffi-dev \
|
|
|
|
|
python3-pip python3-setuptools sqlite3 \
|
|
|
|
|
libssl-dev virtualenv libjpeg-dev libxslt1-dev libicu-dev
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
apt install matrix-synapse-py3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
This leaves a very basic configuration in `/etc/matrix-synapse/homeserver.yaml`
|
|
|
|
|
and two settings under `/etc/conf.d`. All other configuration items will also
|
|
|
|
|
be configured with yaml-files in this directory.
|
|
|
|
|
|
|
|
|
|
Configure the domain you with to use in `/etc/matrix-synapse/conf.d/server_name.yaml`.
|
|
|
|
|
What you configure here will also be the global part of your Matrix handles
|
|
|
|
|
(the part after the colon).
|
|
|
|
|
|
|
|
|
|
You now have a standard Matrix server that uses sqlite. You really don't want
|
|
|
|
|
to use this in production, so probably want to replace this with PostgreSQL.
|
|
|
|
|
|
|
|
|
|
There are two different ways to configure Synapse, documented here:
|
2024-11-04 15:03:22 +01:00
|
|
|
|
|
|
|
|
* [Monolithic](monolithic)
|
|
|
|
|
* [Workers](workers)
|
|
|
|
|
|
2024-11-04 15:13:18 +01:00
|
|
|
We'll use Synapse, using the workers architecture to make it scalable, flexible and reusable.
|
2024-11-04 15:18:52 +01:00
|
|
|
|
2024-11-04 15:25:28 +01:00
|
|
|
# Database
|
2024-11-04 15:18:52 +01:00
|
|
|
|
2024-11-04 15:25:28 +01:00
|
|
|
The default installation leaves you with an sqlite3 database. Nice for experimenting, but
|
|
|
|
|
unsuitable for a production environment.
|
|
|
|
|
|
|
|
|
|
[Here's how you setup PostgreSQL](../postgres).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Logging
|
2024-11-04 15:18:52 +01:00
|
|
|
|
|
|
|
|
Logging is configured in `log.yaml`. Some logging should go to systemd, the
|
|
|
|
|
more specific logging to Synapse's own logfile(s).
|
|
|
|
|
|
|
|
|
|
|
