Synapse mit Docker - Versionsgeschichte

Tommes am 2. März 2025 um 08:05 Uhr

2025-03-02T08:05:24Z

← Nächstältere Version		Version vom 2. März 2025, 08:05 Uhr
Zeile 1:		Zeile 1:
	Matrix / Synapse ist ein dezentraler Messenger-Server, für den es für alle gängigen Plattformen Client-Programme gibt . Er unterstützt neben Ende-zu-Ende verschlüsselten Chat auch Voice-over-IP und steht unter der GPL-kompatiblen Apache-Lizenz.		== Worum geht es? ==
	Nachrichten werden über die Servergrenzen hinaus nach dem einfachen Schema @Kontakt:matrix.domain.eu versendet.		Matrix / Synapse ist ein dezentraler Messenger-Server, für den es für alle gängigen Plattformen Client-Programme gibt. Er unterstützt neben Ende-zu-Ende verschlüsselten Chat auch Voice-over-IP und steht unter der GPL-kompatiblen Apache-Lizenz. Nachrichten werden über die Servergrenzen hinaus nach dem einfachen Schema @Kontakt:matrix.domain.eu versendet.

	Hier zeige ich euch wie Ihr es mittels Docker auf eure DiskStation installiert.		Hier zeige ich euch, wie Ihr es mittels Docker auf eure DiskStation installiert.

	= Voraussetzungen =		= Voraussetzungen =
	* Docker >= 18.09.0 (Empfohlen ist ganz klar immer die letzte/neuste Version!)		* Docker >= 18.09.0 (Empfohlen ist ganz klar immer die letzte/neuste Version!)
	* PostgreSQL >= 13 (ich zeige euch hier wie ihr eueren eigenen PostgreSQL-Server via Docker aufsetzt)		* PostgreSQL >= 13 (ich zeige euch hier, wie ihr eueren eigenen PostgreSQL-Server via Docker aufsetzt)
	* eure DS sollte ca. 1GB freien RAM haben! (ca. 350mb für Synapse, ca. 550mb für PostgreSQL)		* eure DS sollte ca. 1GB freien RAM haben! (ca. 350mb für Synapse, ca. 550mb für PostgreSQL)
	:(es geht zwar ohne PostgreSQL und mit SQLite ... aber aus Performance-Gründen ist die PostgreSQL-Variante vorzuziehen)		:(es geht zwar ohne PostgreSQL und mit SQLite ... aber aus Performance-Gründen ist die PostgreSQL-Variante vorzuziehen)
Zeile 12:		Zeile 12:

	= Per root auf seiner DS anmelden =		= Per root auf seiner DS anmelden =
	Erklärung sollte nicht nötig sein. Wer hier scheitert sollte besser aufhören!		Erklärung sollte nicht nötig sein. Wer hier scheitert, sollte besser aufhören! Alles Weitere geschieht als root!
	Alles ~~weitere~~ geschieht als root!

	= Eigene Docker-Netzwerke anlegen =		= Eigene Docker-Netzwerke anlegen =
Zeile 21:		Zeile 20:

	= Gemeinsamen Ordner für Synapse und PostgreSQL anlegen =		= Gemeinsamen Ordner für Synapse und PostgreSQL anlegen =
	Neuen Ordner für synapse, postgres und pgadmin über die DSM-Oberfläche anlegen, am besten in einem speziell für Docker angelegten eigenen ~~Gemeinsamen~~ Ordner (bei mir /volume1/docker). Da Docker-Container bei "schlechter Führung" eh größtenteils mit root-Rechten auf Dateiebene arbeiten bringt das keinen wirklichen Schutz vor Dateiübergreifenden Rechten, ich fühle mich aber besser dabei ;-)		Neuen Ordner für synapse, postgres und pgadmin über die DSM-Oberfläche anlegen, am besten in einem speziell für Docker angelegten eigenen gemeinsamen Ordner (bei mir /volume1/docker). Da Docker-Container bei "schlechter Führung" eh größtenteils mit root-Rechten auf Dateiebene arbeiten bringt das keinen wirklichen Schutz vor Dateiübergreifenden Rechten, ich fühle mich aber besser dabei ;-) Hier meine später genutzten Pfade:
	Hier meine später genutzten Pfade:
	<pre>/volume1/docker/synapse		<pre>/volume1/docker/synapse
	/volume1/docker/postgres		/volume1/docker/postgres
Zeile 36:		Zeile 34:

	= Dateirechte für PGadmin4 abändern =		= Dateirechte für PGadmin4 abändern =
	pgadmin läuft unter dem Benutzer pgadmin mit der UID=5050 und der GID=5050. Deshalb muss der Ordner, der als Volume gemappt wird angepasst werden.		pgadmin läuft unter dem Benutzer pgadmin mit der UID=5050 und der GID=5050. Deshalb muss der Ordner, der als Volume gemappt wird, angepasst werden.

	>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:		>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:
Zeile 83:		Zeile 81:

	OK</pre>		OK</pre>
	Ich nehme hier matrix als Name, da ja der Dienst so heißt und Synapse nur der Name der Anwendung ist, welche den Dienst ~~bereit stellt~~.		Ich nehme hier matrix als Name, da ja der Dienst so heißt und Synapse nur der Name der Anwendung ist, welche den Dienst bereitstellt. Ist Geschmacksache.
	Ist Geschmacksache.

	= Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen =		= Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen =
Zeile 142:		Zeile 139:
	-p 8448:8448 \		-p 8448:8448 \
	matrixdotorg/synapse:latest generate</pre>		matrixdotorg/synapse:latest generate</pre>
	'''SYNAPSE_SERVER_NAME:'''		'''SYNAPSE_SERVER_NAME:''' Dabei natürlich die eigene Domain eintragen (hier bei mir der Reverse-Proxy-Eintrag, der später auch als URL dienen soll). Ein Reverse-Proxy ist meiner Meinung nach zwingend erforderlich, da ihr euch sonst mit SSL rumschlagen müsst, wovon ich nur abraten kann, da es einen erheblichen Mehraufwand in der Konfiguration bedeutet.
	Dabei natürlich die eigene Domain eintragen (hier bei mir der Reverse-Proxy-Eintrag der später auch als URL dienen soll). Ein Reverse-Proxy ist meiner Meinung nach zwingend erforderlich, da ihr euch sonst mit SSL rumschlagen müsst, wovon ich nur abraten kann, da es ~~ein~~ erheblichen Mehraufwand in der Konfiguration bedeutet.

	'''UID und GID:'''		'''UID und GID:'''
Zeile 149:		Zeile 145:

	= Log-Config für Synapse erstellen bzw. überprüfen =		= Log-Config für Synapse erstellen bzw. überprüfen =
	Ich bin mir gerade nicht mehr sicher ob ich die selbst erstellt habe oder ob diese im Schritt Starten des Synapse-Docker-Containers automatisch erstellt wird. Ihr könnt diesen Schritt ja erstmal überspringen und schauen was passiert. Falls der Synapse Log meckert dann einfach diese Datei nachträglich erstellen!		Ich bin mir gerade nicht mehr sicher, ob ich die selbst erstellt habe oder ob diese im Schritt Starten des Synapse-Docker-Containers automatisch erstellt wird. Ihr könnt diesen Schritt ja erstmal überspringen und schauen was passiert. Falls der Synapse Log meckert dann einfach diese Datei nachträglich erstellen!

	Per DSM-Oberfläche eine Datei /volume1/docker/synapse/matrix.yourdomain.synology.me.log.config anlegen (falls nicht schon vorhanden) mit folgendem Inhalt:		Per DSM-Oberfläche eine Datei /volume1/docker/synapse/matrix.yourdomain.synology.me.log.config anlegen (falls nicht schon vorhanden) mit folgendem Inhalt:
Zeile 177:		Zeile 173:

	= homeserver.yaml anpassen / bearbeiten =		= homeserver.yaml anpassen / bearbeiten =
	Ich erwähne hier nur die wichtigsten Einträge. Wer mehr erfahren will schaut sich die docs an (https://github.com/matrix-org/synapse/blob/develop/docs/sample_config.yaml)		Ich erwähne hier nur die wichtigsten Einträge. Wer mehr erfahren will, schaut sich die docs an (https://github.com/matrix-org/synapse/blob/develop/docs/sample_config.yaml)
	<pre>server_name: "matrix.yourdomain.synology.me"		<pre>server_name: "matrix.yourdomain.synology.me"

Zeile 235:		Zeile 231:

	= Dateirechte für Synapse abändern =		= Dateirechte für Synapse abändern =
	Den Docker Container mit admin oder root Dateirechten laufen zu lassen wäre höchst ~~Sicherheitskritisch~~. Deshalb lasse ich ihn mit abgeänderten Dateirechten laufen. Dazu müssen wir aber auch die Dateirechte der vorhandenen Dateien (wie z.B. der homeserver.yaml) ändern.		Den Docker Container mit admin oder root Dateirechten laufen zu lassen wäre höchst sicherheitskritisch. Deshalb lasse ich ihn mit abgeänderten Dateirechten laufen. Dazu müssen wir aber auch die Dateirechte der vorhandenen Dateien (wie z.B. der homeserver.yaml) ändern.

	>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:		>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:
Zeile 272:		Zeile 268:
	Für DSM 5 oder 6:		Für DSM 5 oder 6:

	Jetzt wird es etwas tricky ... das Anpassen der Reverse-Proxy Configuration, die nach jeder Änderung an den Reverse-Proxy-Einträgen über die DSM-Oberfläche nötig wird, da die Config hier ~~jedesmal~~ durch Synology überschrieben wird!		Jetzt wird es etwas tricky ... das Anpassen der Reverse-Proxy Configuration, die nach jeder Änderung an den Reverse-Proxy-Einträgen über die DSM-Oberfläche nötig wird, da die Config hier jedes Mal durch Synology überschrieben wird!

	Ladet euch mein Skript von meinem Github und speichert es an einem beliebigen Ort in eure DiskStation (bei mir /volume1/backup):		Ladet euch mein Skript von meinem Github und speichert es an einem beliebigen Ort in eure DiskStation (bei mir /volume1/backup):
	https://github.com/3x3cut0r/synology/blob/master/updateReverseProxyEntryForSynapse.sh		https://github.com/3x3cut0r/synology/blob/master/updateReverseProxyEntryForSynapse.sh. Anschließend ändert ihr noch Zeile 29-32 an eure Gegebenheiten ab!
	Anschließend ändert ihr noch Zeile 29-32 an eure Gegebenheiten ab!

	Erstellt euch eine neue Aufgabe über die DSM:		Erstellt euch eine neue Aufgabe über die DSM:
Zeile 288:		Zeile 283:
	Benutzerdefiniertes Script		Benutzerdefiniertes Script
	/volume1/backup/updateReverseProxyEntryForSynapse.sh</pre>		/volume1/backup/updateReverseProxyEntryForSynapse.sh</pre>
	Dieses Script dann händisch einmalig ausführen nachdem ihr etwas an den Reverse-Proxy-Einträgen verändert habt.		Dieses Script dann händisch einmalig ausführen, nachdem ihr etwas an den Reverse-Proxy-Einträgen verändert habt.

	Wer dem Script nicht vertraut kann die Einträge auch händisch mit nano oder vi auf Konsole durchführen. Der Pfad der Config-Datei ist:		Wer dem Script nicht vertraut kann die Einträge auch händisch mit nano oder vi auf Konsole durchführen. Der Pfad der Config-Datei ist:

imported>3x3cut0r: /* Anpassen der Reverse-Proxy Config eurer NAS */

2022-12-13T23:23:46Z

Anpassen der Reverse-Proxy Config eurer NAS

@@ Zeile 255: / Zeile 255: @@
 docker network connect synapse-net synapse</pre>
-= Anpassen der Reverse-Proxy Config eurer NAS =
+= Anpassen der Reverse-Proxy Config eurer NAS (funktioniert nicht mehr ab DSM 7.x !!!)=
 Jetzt wird es etwas tricky ... das Anpassen der Reverse-Proxy Configuration, die nach jeder Änderung an den Reverse-Proxy-Einträgen über die DSM-Oberfläche nötig wird, da die Config hier jedesmal durch Synology überschrieben wird!

imported>3x3cut0r: /* Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen */

2021-02-01T16:49:00Z

Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen

← Nächstältere Version		Version vom 1. Februar 2021, 16:49 Uhr
Zeile 120:		Zeile 120:
	Definition:		Definition:
	Encoding: UTF8		Encoding: UTF8
	Template: template0		Template: postgres (oder template0)
	Tablespace: pg_default		Tablespace: pg_default
	Collation: C		Collation: C

imported>3x3cut0r: /* Starten des Synapse-Docker-Containers */

2021-01-27T06:23:36Z

Starten des Synapse-Docker-Containers

← Nächstältere Version		Version vom 27. Januar 2021, 06:23 Uhr
Zeile 243:		Zeile 243:
	<pre>docker container run -d --restart=always \		<pre>docker container run -d --restart=always \
	--name=synapse \		--name=synapse \
	--network ~~synapse~~-net \		--network postgres-net \
	-v /volume1/docker/synapse:/data \		-v /volume1/docker/synapse:/data \
	-e SYNAPSE_WORKER=synapse.app.homeserver \		-e SYNAPSE_WORKER=synapse.app.homeserver \
Zeile 253:		Zeile 253:
	matrixdotorg/synapse:latest		matrixdotorg/synapse:latest

	docker network connect ~~postgres~~-net synapse</pre>		docker network connect synapse-net synapse</pre>

	= Anpassen der Reverse-Proxy Config eurer NAS =		= Anpassen der Reverse-Proxy Config eurer NAS =

imported>3x3cut0r: /* Docker-Container für PGadmin4 anlegen */

2021-01-26T15:19:48Z

Docker-Container für PGadmin4 anlegen

← Nächstältere Version		Version vom 26. Januar 2021, 15:19 Uhr
Zeile 52:		Zeile 52:
	-p 8180:80 \		-p 8180:80 \
	-v /volume1/docker/pgadmin:/var/lib/pgadmin \		-v /volume1/docker/pgadmin:/var/lib/pgadmin \
	~~-v /volume1/docker/pgadmin/certs:/certs \~~
	dpage/pgadmin4:latest</pre>		dpage/pgadmin4:latest</pre>

imported>3x3cut0r am 26. Januar 2021 um 15:15 Uhr

2021-01-26T15:15:59Z

← Nächstältere Version		Version vom 26. Januar 2021, 15:15 Uhr
Zeile 34:		Zeile 34:
	-e POSTGRES_PASSWORD='STRONG_POSTGRES_ROOT_PASSWORD' \		-e POSTGRES_PASSWORD='STRONG_POSTGRES_ROOT_PASSWORD' \
	postgres:13.1-alpine</pre>		postgres:13.1-alpine</pre>

			= Dateirechte für PGadmin4 abändern =
			pgadmin läuft unter dem Benutzer pgadmin mit der UID=5050 und der GID=5050. Deshalb muss der Ordner, der als Volume gemappt wird angepasst werden.

			>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:
			<pre>chown -R 5050:5050 /volume1/docker/pgadmin
			chmod -R 0700 /volume1/docker/pgadmin</pre>

	= Docker-Container für PGadmin4 anlegen =		= Docker-Container für PGadmin4 anlegen =
Zeile 78:		Zeile 85:
	OK</pre>		OK</pre>
	Ich nehme hier matrix als Name, da ja der Dienst so heißt und Synapse nur der Name der Anwendung ist, welche den Dienst bereit stellt.		Ich nehme hier matrix als Name, da ja der Dienst so heißt und Synapse nur der Name der Anwendung ist, welche den Dienst bereit stellt.
	Ist ~~Geschmackssache~~.		Ist Geschmacksache.

	= Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen =		= Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen =
Zeile 228:		Zeile 235:
	suppress_key_server_warning: true</pre>		suppress_key_server_warning: true</pre>

	= Dateirechte abändern =		= Dateirechte für Synapse abändern =
	Den Docker Container mit admin oder root Dateirechten laufen zu lassen wäre höchst Sicherheitskritisch. Deshalb lasse ich ihn mit abgeänderten Dateirechten laufen. Dazu müssen wir aber auch die Dateirechte der vorhandenen Dateien (wie z.B. der homeserver.yaml) ändern.		Den Docker Container mit admin oder root Dateirechten laufen zu lassen wäre höchst Sicherheitskritisch. Deshalb lasse ich ihn mit abgeänderten Dateirechten laufen. Dazu müssen wir aber auch die Dateirechte der vorhandenen Dateien (wie z.B. der homeserver.yaml) ändern.

imported>3x3cut0r: /* Anpassen der Reverse-Proxy Config eurer NAS */

2021-01-19T09:33:06Z

Anpassen der Reverse-Proxy Config eurer NAS

← Nächstältere Version		Version vom 19. Januar 2021, 09:33 Uhr
Zeile 308:		Zeile 308:
	proxy_set_header X-Forwarded-Proto $scheme;		proxy_set_header X-Forwarded-Proto $scheme;

	proxy_pass http://192.168.178.254:8008;		proxy_pass http://192.168.178.254:8008;</pre>
			<pre style="color:red;">client_max_body_size 64M;</pre>
	client_max_body_size 64M;		<pre>}</pre>
			<pre style="color:red;">
	}

	location ~* ^(\/_matrix\|\/_synapse\/client) {		location ~* ^(\/_matrix\|\/_synapse\/client) {
	proxy_pass http://192.168.178.254:8008;		proxy_pass http://192.168.178.254:8008;
Zeile 348:		Zeile 346:
	proxy_set_header Connection "Upgrade";		proxy_set_header Connection "Upgrade";
	proxy_set_header X-Forwarded-For $remote_addr;		proxy_set_header X-Forwarded-For $remote_addr;
	}		}</pre><pre>

	error_page 403 404 500 502 503 504 @error_page;		error_page 403 404 500 502 503 504 @error_page;

imported>3x3cut0r: Die Seite wurde neu angelegt: „Matrix / Synapse ist ein dezentraler Messenger-Server, für den es für alle gängigen Plattformen Client-Programme gibt . Er unterstützt neben Ende-zu-Ende v…“

2021-01-19T09:18:39Z

Die Seite wurde neu angelegt: „Matrix / Synapse ist ein dezentraler Messenger-Server, für den es für alle gängigen Plattformen Client-Programme gibt . Er unterstützt neben Ende-zu-Ende v…“

Neue Seite

Matrix / Synapse ist ein dezentraler Messenger-Server, für den es für alle gängigen Plattformen Client-Programme gibt . Er unterstützt neben Ende-zu-Ende verschlüsselten Chat auch Voice-over-IP und steht unter der GPL-kompatiblen Apache-Lizenz.
Nachrichten werden über die Servergrenzen hinaus nach dem einfachen Schema @Kontakt:matrix.domain.eu versendet.

Hier zeige ich euch wie Ihr es mittels Docker auf eure DiskStation installiert.

= Voraussetzungen =
* Docker >= 18.09.0 (Empfohlen ist ganz klar immer die letzte/neuste Version!)
* PostgreSQL >= 13 (ich zeige euch hier wie ihr eueren eigenen PostgreSQL-Server via Docker aufsetzt)
* eure DS sollte ca. 1GB freien RAM haben! (ca. 350mb für Synapse, ca. 550mb für PostgreSQL)
:(es geht zwar ohne PostgreSQL und mit SQLite ... aber aus Performance-Gründen ist die PostgreSQL-Variante vorzuziehen)
* etwas Linux Kenntnisse, wie man sich auf der Shell bewegt, sich per SSH und als root auf seiner DS anmeldet und Linux Syntax verstehen bzw. anwenden können ist sehr von Vorteil!

= Per root auf seiner DS anmelden =
Erklärung sollte nicht nötig sein. Wer hier scheitert sollte besser aufhören!
Alles weitere geschieht als root!

= Eigene Docker-Netzwerke anlegen =
(Optional, ich will aber nicht das jeder Docker Container jeden anderen im Netzwerk erreichen kann, sondern nur die Container, die sich auch erreichen sollen!)
<pre>docker network create synapse-net
docker network create postgres-net</pre>

= Gemeinsamen Ordner für Synapse und PostgreSQL anlegen =
Neuen Ordner für synapse, postgres und pgadmin über die DSM-Oberfläche anlegen, am besten in einem speziell für Docker angelegten eigenen Gemeinsamen Ordner (bei mir /volume1/docker). Da Docker-Container bei "schlechter Führung" eh größtenteils mit root-Rechten auf Dateiebene arbeiten bringt das keinen wirklichen Schutz vor Dateiübergreifenden Rechten, ich fühle mich aber besser dabei ;-)
Hier meine später genutzten Pfade:
<pre>/volume1/docker/synapse
/volume1/docker/postgres
/volume1/docker/pgadmin</pre>

= Docker-Container für Postgres anlegen/erstellen =
<pre>docker container run -d --restart=always \
--name=postgres \
--network postgres-net \
-v /volume1/docker/postgres:/var/lib/postgresql/data \
-e POSTGRES_PASSWORD='STRONG_POSTGRES_ROOT_PASSWORD' \
postgres:13.1-alpine</pre>

= Docker-Container für PGadmin4 anlegen =
Weboberfläche, um damit die PostgreSQL-DB zu administrieren
<pre>docker container run -d --restart=always \
--name=pgadmin \
--network postgres-net \
-e PGADMIN_DEFAULT_EMAIL='postgresadmin@yourdomain.synology.me' \
-e PGADMIN_DEFAULT_PASSWORD='STRONG_POSTGRESADMIN_PASSWORD' \
-e 'PGADMIN_CONFIG_ENHANCED_COOKIE_PROTECTION=True' \
-p 8180:80 \
-v /volume1/docker/pgadmin:/var/lib/pgadmin \
-v /volume1/docker/pgadmin/certs:/certs \
dpage/pgadmin4:latest</pre>

= Reverse-Proxy-Einträge für PGadmin4 und Synapse bzw. Matrix über die DSM-Oberfläche erstellen =
<pre>Systemsteuerung / Anwendungsportal / Reverse-Proxy / Erstellen
Beschreibung: pgAdmin4
Quelle:
Protokoll: HTTPS
Hostname: pgadmin.yourdomain.synology.me
Port: 443
Ziel:
Protokoll: HTTP
Hostname: <IP-Adresse eurer NAS>
Port: 8180

Bei Benutzerdefinierter Header einmal auf das Drop-Down und auf WebSocket klicken

OK</pre>
<pre>Systemsteuerung / Anwendungsportal / Reverse-Proxy / Erstellen
Beschreibung: Synapse
Quelle:
Protokoll: HTTPS
Hostname: matrix.yourdomain.synology.me
Port: 443
Ziel:
Protokoll: HTTP
Hostname: <IP-Adresse eurer NAS>
Port: 8008

Bei Benutzerdefinierter Header einmal auf das Drop-Down und auf WebSocket klicken

OK</pre>
Ich nehme hier matrix als Name, da ja der Dienst so heißt und Synapse nur der Name der Anwendung ist, welche den Dienst bereit stellt.
Ist Geschmackssache.

= Per Weboberfläche mit PGadmin4 eine neue Datenbank für Synapse erstellen =
URL: https://pgadmin.yourdomain.synology.me
Benutzer: postgresadmin@yourdomain.synology.me
Passwort: STRONG_POSTGRESADMIN_PASSWORD

Als erstes natürlich euren Server hinzufügen:
<pre>Rechtsklick auf Servers / Create / Server...
Name: DiskStation

Connection:
Host: postgres
Port: 5432
Username: postgres (siehe 4.)
Passwort: STRONG_POSTGRES_ROOT_PASSWORD (siehe 4.)

SAVE</pre>
Danach einen Datenbank-Benutzer anlegen:
<pre>Rechtsklick auf Login/Group-Roles / Create / Login/Group-Role...
Name: synapse

Definition:
Passwort: STRONG_SYNAPSE_POSTGRES_PASSWORD

Privileges:
Can login? Yes

SAVE</pre>
Danach eine Postgres-Datenbank anlegen:
<pre>Rechtsklick auf Databases / Create / Database...
Database: synapse
Owner: synapse

Definition:
Encoding: UTF8
Template: template0
Tablespace: pg_default
Collation: C
Character type: C
Connection limit: -1

SAVE</pre>
Du kannst pgAdmin4 nun schließen!

= homeserver.yaml generieren lassen =
<pre>docker run -it --rm \
--name=synapse \
--network synapse-net \
-v /volume1/docker/synapse:/data \
-e SYNAPSE_SERVER_NAME=matrix.yourdomain.synology.me \
-e SYNAPSE_REPORT_STATS=yes \
-e TZ='Europe/Berlin' \
-e UID=1024 \
-e GID=100 \
-p 8008:8008 \
-p 8448:8448 \
matrixdotorg/synapse:latest generate</pre>
'''SYNAPSE_SERVER_NAME:'''
Dabei natürlich die eigene Domain eintragen (hier bei mir der Reverse-Proxy-Eintrag der später auch als URL dienen soll). Ein Reverse-Proxy ist meiner Meinung nach zwingend erforderlich, da ihr euch sonst mit SSL rumschlagen müsst, wovon ich nur abraten kann, da es ein erheblichen Mehraufwand in der Konfiguration bedeutet.

'''UID und GID:'''
1024 ist der admin-Account euerer DS und 100 die USERS-Gruppe. In diesem Schritt (generiere homeserver.yaml) lasse ich es so, da man dann schön über die DSM-Oberfläche die homeserver.yaml bearbeiten kann! Später wird dies aus Sicherheitsgründen geändert!

= Log-Config für Synapse erstellen bzw. überprüfen =
Ich bin mir gerade nicht mehr sicher ob ich die selbst erstellt habe oder ob diese im Schritt Starten des Synapse-Docker-Containers automatisch erstellt wird. Ihr könnt diesen Schritt ja erstmal überspringen und schauen was passiert. Falls der Synapse Log meckert dann einfach diese Datei nachträglich erstellen!

Per DSM-Oberfläche eine Datei /volume1/docker/synapse/matrix.yourdomain.synology.me.log.config anlegen (falls nicht schon vorhanden) mit folgendem Inhalt:
<pre>version: 1

formatters:
precise:
format: '%(asctime)s - %(name)s - %(lineno)d - %(levelname)s - %(request)s - %(message)s'

handlers:
console:
class: logging.StreamHandler
formatter: precise
level: INFO

loggers:
synapse.storage.SQL:
# beware: increasing this to DEBUG will make synapse log sensitive
# information such as access tokens.
level: INFO

root:
level: INFO
handlers: [console]

disable_existing_loggers: false</pre>

= homeserver.yaml anpassen / bearbeiten =
Ich erwähne hier nur die wichtigsten Einträge. Wer mehr erfahren will schaut sich die docs an (https://github.com/matrix-org/synapse/blob/develop/docs/sample_config.yaml)
<pre>server_name: "matrix.yourdomain.synology.me"

pid_file: /data/homeserver.pid

public_baseurl: https://matrix.yourdomain.synology.me

listeners:
- port: 8008
bind_addresses:
- '::'
- '0.0.0.0'
tls: false
type: http
x_forwarded: true
resources:
- names: [client, federation]
compress: false

database:
name: psycopg2
args:
user: synapse
password: 'STRONG_SYNAPSE_POSTGRES_PASSWORD'
database: synapse
host: postgres
cp_min: 5
cp_max: 10

log_config: "/data/matrix.yourdomain.synology.me.log.config"

media_store_path: "/data/media_store"

# wichtig, das ihr das auch in eurem Reverse Proxy einstellt!
max_upload_size: 64M

url_preview_accept_language:
- de-DE

# wenn ihr das nicht wollt, dann nach dem registrieren eures eigenen Benutzers wieder auf false setzen!
enable_registration: true

# das registration_shared_secret wird bei euch generiert und sieht anders aus!
registration_shared_secret: "ai&RwSrf!-g+dfj#34-H,6pnsfxhHzCp)-MaA_Emvssw,g3,A,E,TV,&"

# Optional! Nur falls ihr bridges nutzt, dann die jeweiligen configs hier angeben!
app_service_config_files:
- "/data/mautrix-whatsapp/registration.yaml"

# form_secret wird auch generiert und sieht bei euch anders aus!
form_secret: "nex-7m&XhsSSTBp0XtRqrofZu50yPJsd=qIyeb,!HRTSO9@_g*1fdsg"

trusted_key_servers:
- server_name: "matrix.org"

suppress_key_server_warning: true</pre>

= Dateirechte abändern =
Den Docker Container mit admin oder root Dateirechten laufen zu lassen wäre höchst Sicherheitskritisch. Deshalb lasse ich ihn mit abgeänderten Dateirechten laufen. Dazu müssen wir aber auch die Dateirechte der vorhandenen Dateien (wie z.B. der homeserver.yaml) ändern.

>>> Seit euch hier unbedingt des Pfades sicher! Falscher Pfad kann hier irreparablen Schaden an eurer NAS hervorrufen!!! Verwendet am besten Doppel-<TAB> zur Autovervollständigung des Pfades <<<:
<pre>chown -R 991:991 /volume1/docker/synapse</pre>

= Starten des Synapse-Docker-Containers =
<pre>docker container run -d --restart=always \
--name=synapse \
--network synapse-net \
-v /volume1/docker/synapse:/data \
-e SYNAPSE_WORKER=synapse.app.homeserver \
-e TZ='Europe/Berlin' \
-e UID=991 \
-e GID=991 \
-p 8008:8008 \
-p 8448:8448 \
matrixdotorg/synapse:latest

docker network connect postgres-net synapse</pre>

= Anpassen der Reverse-Proxy Config eurer NAS =
Jetzt wird es etwas tricky ... das Anpassen der Reverse-Proxy Configuration, die nach jeder Änderung an den Reverse-Proxy-Einträgen über die DSM-Oberfläche nötig wird, da die Config hier jedesmal durch Synology überschrieben wird!

Ladet euch mein Skript von meinem Github und speichert es an einem beliebigen Ort in eure DiskStation (bei mir /volume1/backup):
https://github.com/3x3cut0r/synology/blob/master/updateReverseProxyEntryForSynapse.sh
Anschließend ändert ihr noch Zeile 29-32 an eure Gegebenheiten ab!

Erstellt euch eine neue Aufgabe über die DSM:
<pre>Systemsteuerung / Aufgabenplaner / Erstellen / Ausgelöste Aufgabe / Benutzerdefiniertes Script

Vorgang: Synapse Reverse Proxy
Benutzer: root
Aktiviert? nein

Aufgabeneinstellungen:
Benutzerdefiniertes Script
/volume1/backup/updateReverseProxyEntryForSynapse.sh</pre>
Dieses Script dann händisch einmalig ausführen nachdem ihr etwas an den Reverse-Proxy-Einträgen verändert habt.

Wer dem Script nicht vertraut kann die Einträge auch händisch mit nano oder vi auf Konsole durchführen. Der Pfad der Config-Datei ist:
<pre>/etc/nginx/app.d/server.ReverseProxy.conf</pre>
Was ihr abändert bzw. einfügen müsst ist (hier rot markiert):
<pre> ...
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;

server_name matrix.yourdomain.synology.me;

ssl_certificate /usr/syno/etc/certificate/ReverseProxy/550d899f-67b3-477b-a6c0-73223ae747c1/fullchain.pem;

ssl_certificate_key /usr/syno/etc/certificate/ReverseProxy/550d899f-67b3-477b-a6c0-73223ae747c1/privkey.pem;

add_header Strict-Transport-Security "max-age=15768000; includeSubdomains; preload" always;

location / {

proxy_connect_timeout 600;

proxy_read_timeout 600;

proxy_send_timeout 600;

proxy_intercept_errors off;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection $connection_upgrade;

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header Host $http_host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_pass http://192.168.178.254:8008;

client_max_body_size 64M;

}

location ~* ^(\/_matrix|\/_synapse\/client) {
proxy_pass http://192.168.178.254:8008;
proxy_connect_timeout 600;
proxy_read_timeout 600;
proxy_send_timeout 600;
proxy_intercept_errors off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 64M;
}

location /.well-known/matrix/client {
return 200 '{"m.homeserver": {"base_url": "https://matrix.yourdomain.synology.me:443"}}';
add_header Content-Type application/json;
add_header Access-Control-Allow-Origin *;
}

location /.well-known/matrix/server {
return 200 '{"m.server": "matrix.yourdomain.synology.me:443"}';
add_header Content-Type application/json;
add_header Access-Control-Allow-Origin *;
}

location /_matrix/maubot {
proxy_pass http://192.168.178.254:29316;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header X-Forwarded-For $remote_addr;
}

error_page 403 404 500 502 503 504 @error_page;

location @error_page {
root /usr/syno/share/nginx;
rewrite (.*) /error.html break;
allow all;
}

}
...</pre>
Anschließend nginx einmal reloaden:
<pre>nginx -s reload</pre>

= FERTIG! =
Nun könnt ihr euch z.B. mit Element (https://element.io/) und einem Client an eurem eigenen Matrix/Synapse-Server registrieren bzw. anmelden!

[[Benutzer:3x3cut0r|3x3cut0r]] 10:18 Uhr, 19. Jan. 2021 (CEST)