Projects/Matrix HS - Bewerkingsoverzicht

Polyfloyd op 2 jan 2026 om 21:30

2026-01-02T21:30:32Z

← Oudere versie		Versie van 2 jan 2026 21:30
Regel 1:		Regel 1:
	{{Project		{{Project
	\|name=Matrix homeserver		\|name=Matrix homeserver
	\|start=2021/11/15		\|start=2021-11-15
	\|contact=~~User:~~Flimpie		\|contact=Flimpie
	\|info=Matrix homeserver tbv Bitlair members		\|info=Matrix homeserver tbv Bitlair members
	\|status=~~Production~~		\|status=Abandoned
	}}		}}

	Birlair biedt voor deelnemers een Matrix homeserver aan. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.		Birlair biedt voor deelnemers een Matrix homeserver aan. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.

Flimpie op 8 mrt 2023 om 20:17

2023-03-08T20:17:39Z

← Oudere versie		Versie van 8 mrt 2023 20:17
Regel 4:		Regel 4:
	\|contact=User:Flimpie		\|contact=User:Flimpie
	\|info=Matrix homeserver tbv Bitlair members		\|info=Matrix homeserver tbv Bitlair members
	\|status=~~Ongoing~~		\|status=Production
	}}		}}

Flimpie op 8 mrt 2023 om 20:17

2023-03-08T20:17:27Z

← Oudere versie		Versie van 8 mrt 2023 20:17
Regel 2:		Regel 2:
	\|name=Matrix homeserver		\|name=Matrix homeserver
	\|start=2021/11/15		\|start=2021/11/15
	\|contact=User:~~Hillebrand~~		\|contact=User:Flimpie
	\|info=Matrix homeserver tbv Bitlair members		\|info=Matrix homeserver tbv Bitlair members
	\|status=~~Alpha~~		\|status=Ongoing
	}}		}}

	~~[[Polyfloyd]] heeft mij gevraagd om bij wijze van proef~~ een Matrix-homeserver ~~op te zetten~~. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.		Birlair biedt voor deelnemers een Matrix homeserver aan. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.

	Je kan inloggen met je LDAP-account.		Je kan inloggen met je LDAP-account.

Flimpie op 8 mrt 2023 om 20:16

2023-03-08T20:16:22Z

← Oudere versie		Versie van 8 mrt 2023 20:16
Regel 9:		Regel 9:
	[[Polyfloyd]] heeft mij gevraagd om bij wijze van proef een Matrix-homeserver op te zetten. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.		[[Polyfloyd]] heeft mij gevraagd om bij wijze van proef een Matrix-homeserver op te zetten. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.

	Je kan inloggen met je LDAP-account~~. Let wel dat de server nog in testfase is, dus geen garanties voor (goede) werking~~.		Je kan inloggen met je LDAP-account.

	De 'realm' van de Matrix-server is bitlair.nl, de homeserver staat op matrix.bitlair.nl		De 'realm' van de Matrix-server is bitlair.nl, de homeserver staat op matrix.bitlair.nl
Regel 210:		Regel 210:
	<nowiki>iptables -t nat -I POSTROUTING -s 172.19.0.0/16 ! -o br-634561587f89 -j SNAT --to-source 185.205.52.200		<nowiki>iptables -t nat -I POSTROUTING -s 172.19.0.0/16 ! -o br-634561587f89 -j SNAT --to-source 185.205.52.200
	iptables -t nat -I POSTROUTING -s 172.18.0.0/16 ! -o br-5275cf72302f -j SNAT --to-source 185.205.52.200		iptables -t nat -I POSTROUTING -s 172.18.0.0/16 ! -o br-5275cf72302f -j SNAT --to-source 185.205.52.200
	iptables -t nat -I POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j SNAT --to-source 185.205.52.200/nowiki>		iptables -t nat -I POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j SNAT --to-source 185.205.52.200</nowiki>

	De br-nnnnnn interfaces veranderen niet van naam (tenzij je het playbook uninstallt vanzelfsprekend), deze zijn gekoppeld aan een docker containernetwerk. (probeer bijv <code>docker network inspect		De br-nnnnnn interfaces veranderen niet van naam (tenzij je het playbook uninstallt vanzelfsprekend), deze zijn gekoppeld aan een docker containernetwerk. (probeer bijv <code>docker network inspect
Regel 230:		Regel 230:

	=== User toevoegen ===		=== User toevoegen ===

			Dit voegt een _lokale_ user toe.

	# /usr/local/bin/matrix-synapse-register-user <your-username> <your-password> <admin access: 0 or 1>		# /usr/local/bin/matrix-synapse-register-user <your-username> <your-password> <admin access: 0 or 1>

	~~Graag usernames in testfase prefixen met DEMO_~~		== Troubleshooting ==

			=== Services (specifiek IRC) doen raar na apt upgrade ===

			<code>systemctl restart docker-iptables</code>

	== To-do ==		== To-do ==

Sam op 4 dec 2021 om 08:39

2021-12-04T08:39:43Z

← Oudere versie		Versie van 4 dec 2021 08:39
Regel 7:		Regel 7:
	}}		}}

	~~Het bestuur (bij monde van~~ [[Polyfloyd]]) heeft mij gevraagd om bij wijze van proef een Matrix-homeserver op te zetten. Dit om toegang tot de		[[Polyfloyd]] heeft mij gevraagd om bij wijze van proef een Matrix-homeserver op te zetten. Dit om toegang tot de IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.
	IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.

	Je kan inloggen met je LDAP-account. Let wel dat de server nog in testfase is, dus geen garanties voor (goede) werking.		Je kan inloggen met je LDAP-account. Let wel dat de server nog in testfase is, dus geen garanties voor (goede) werking.
Regel 15:		Regel 14:

	== Gebruik ==		== Gebruik ==
	* Log in met Element web (de de-facto web client voor Matrix, wordt by default geinstalleerd met het ansible playbook) op element.bitlair.nl
			In beide gevallen is je username op IRC gelijk aan je localpart (@testuser:example.org en @flimpie:bitlair.nl worden respectievelijk testuser en flimpie).

			Dit kan je wijzigen. Nadat je joint krijg je een invite voor een PM met de 'statusbot'. Als je naar de bot '!nick irc.smurfnet.ch je_nieuwe_username' stuurt wordt je username gewijzigd.

			Als iemand anders (of jijzelf met een andere client) al je username heeft komt daar een suffix achter (bijv test wordt test1). Je krijgt altijd als je verbindt een berichtje van de statusbot met als inhoud "You've been connected to the IRC network 'irc.smurfnet.ch' as JE_USERNAME".

			=== Zelf inloggen op de server, met LDAP account) ===

			* Log in met Element web (de de-facto web client voor Matrix, wordt by default geinstalleerd met het ansible playbook) op element.bitlair.nl, log in met je LDAP username en password.
	* OF gebruik een andere matrix-client en stuur die naar matrix.bitlair.nl		* OF gebruik een andere matrix-client en stuur die naar matrix.bitlair.nl
	* Join #bitlair:bitlair.nl om in de bridge naar #bitlair te komen		* Join #bitlair:bitlair.nl [https://matrix.to/#/#bitlair:bitlair.nl] om in de bridge naar #bitlair te komen

			=== Inloggen vanaf een andere homeserver ===

			* Join het kanaal. [https://matrix.to/#/#bitlair:bitlair.nl]

	== Configuratie ==		== Configuratie ==
Regel 196:		Regel 208:
	De volgende regels SNATten de bridges die docker maakt:		De volgende regels SNATten de bridges die docker maakt:

	<nowiki>-A POSTROUTING -s 172.19.0.0/16 ! -o br-~~c21c06bc9787~~ -j SNAT --to-source 185.205.52.200		<nowiki>iptables -t nat -I POSTROUTING -s 172.19.0.0/16 ! -o br-634561587f89 -j SNAT --to-source 185.205.52.200
	-A POSTROUTING -s 172.18.0.0/16 ! -o br-~~bcf36440d8a7~~ -j SNAT --to-source 185.205.52.200		iptables -t nat -I POSTROUTING -s 172.18.0.0/16 ! -o br-5275cf72302f -j SNAT --to-source 185.205.52.200
	-A POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j SNAT --to-source 185.205.52.200</nowiki>		iptables -t nat -I POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j SNAT --to-source 185.205.52.200/nowiki>

	De br-nnnnnn interfaces veranderen niet van naam, deze zijn gekoppeld aan een docker containernetwerk. (probeer bijv <code>docker network inspect		De br-nnnnnn interfaces veranderen niet van naam (tenzij je het playbook uninstallt vanzelfsprekend), deze zijn gekoppeld aan een docker containernetwerk. (probeer bijv <code>docker network inspect
	bcf36440d8a7</code>)		bcf36440d8a7</code>)

Regel 227:		Regel 239:
	Alles hieronder is een richtlijn, allemaal at the discretion van het bestuur		Alles hieronder is een richtlijn, allemaal at the discretion van het bestuur

	* Nieuwe room maken en die configureren als bridgeroom voor #bitlair. Op dit moment heet de room die #bitlair bridget #smurfnet_#bitlair:matrix.bitlair.nl, dat is op zijn zachtst gezegd een beetje onhandig. Dit zou dus #bitlair:matrix.bitlair.nl kunnen worden.
	* Koppelen aan LDAP, zodat members met hun gebruikelijke account kunnen inloggen (maar de rooms zijn gebridged dus iemand kan prima van een andere/zijn eigen HS joinen, de room op Matrix is net zo publiek als op IRC)
	* ...		* ...

Sam op 4 dec 2021 om 08:28

2021-12-04T08:28:35Z

← Oudere versie		Versie van 4 dec 2021 08:28
Regel 28:		Regel 28:
	deze lokaal buiten enige version control.		deze lokaal buiten enige version control.

	<nowiki>matrix_domain: ~~matrix.~~bitlair.nl		<nowiki>matrix_domain: bitlair.nl

	matrix_ssl_retrieval_method: lets-encrypt		matrix_ssl_retrieval_method: lets-encrypt
Regel 35:		Regel 35:
	# A shared secret (between Coturn and Synapse) used for authentication.		# A shared secret (between Coturn and Synapse) used for authentication.
	# You can put any string here, but generating a strong one is preferred (e.g. `pwgen -s 64 1`).		# You can put any string here, but generating a strong one is preferred (e.g. `pwgen -s 64 1`).
	matrix_coturn_turn_static_auth_secret: "~~GEHEIM~~"		matrix_coturn_turn_static_auth_secret: "nice try"

	# A secret used to protect access keys issued by the server.		# A secret used to protect access keys issued by the server.
	# You can put any string here, but generating a strong one is preferred (e.g. `pwgen -s 64 1`).		# You can put any string here, but generating a strong one is preferred (e.g. `pwgen -s 64 1`).
	matrix_synapse_macaroon_secret_key: "~~GEHEIM~~"		matrix_synapse_macaroon_secret_key: "nice try"

	matrix_well_known_matrix_server_enabled: true		matrix_well_known_matrix_server_enabled: true

	matrix_postgres_connection_password: '~~GEHEIM~~'		matrix_postgres_connection_password: 'nice try'
	matrix_nginx_proxy_worker_connections: 8192		matrix_nginx_proxy_worker_connections: 8192
	matrix_nginx_proxy_worker_processes: 8		matrix_nginx_proxy_worker_processes: 8
Regel 49:		Regel 49:
	matrix_synapse_workers_enabled: true		matrix_synapse_workers_enabled: true

	matrix_common_after_systemd_service_start_wait_for_timeout_seconds: ~~600~~		matrix_common_after_systemd_service_start_wait_for_timeout_seconds: 240

	matrix_synapse_admin_enabled: true		matrix_synapse_admin_enabled: true
Regel 67:		Regel 67:
	ggIBAPFua0cL9FPbBsZU53eZbYeBDX7aArAzkA68JnSpATX34RvvNyvi7mAzEyzN		ggIBAPFua0cL9FPbBsZU53eZbYeBDX7aArAzkA68JnSpATX34RvvNyvi7mAzEyzN
	j347N7sN4LmotkGRHnuK7jp8gmuVrH53ecJxrQXaKgEVWe/JcgHIftZHs3fl6iBA		j347N7sN4LmotkGRHnuK7jp8gmuVrH53ecJxrQXaKgEVWe/JcgHIftZHs3fl6iBA
			za9c4M+d2BtzcyKs6GHkSIPRerdMO5fjbiusWdHpTIvjTwo1BugQoAtszhZ/20cs
	3028VUAVoEvplky+/w1elPTP6VDwHNdYo/a4e5pzf3+WjdUFvuOs7R1g+1KVdxv9		3028VUAVoEvplky+/w1elPTP6VDwHNdYo/a4e5pzf3+WjdUFvuOs7R1g+1KVdxv9
	lxsOcPwHtiQgwFXhQuqjR7GSCq5j7QsM6DyYU2GbZadmyagE40OVCg12gli8ZWaF		lxsOcPwHtiQgwFXhQuqjR7GSCq5j7QsM6DyYU2GbZadmyagE40OVCg12gli8ZWaF
Regel 114:		Regel 115:
	federate: true		federate: true
	aliasTemplate: "#irc_$CHANNEL"		aliasTemplate: "#irc_$CHANNEL"
			mappings:
			"#bitlair":
			roomIds: ["!qBaVlwurBmrZYdkQLA:bitlair.nl"]
	membershipLists:		membershipLists:
	enabled: true		enabled: true
Regel 124:		Regel 128:
	initial: true		initial: true
	incremental: true		incremental: true
	~~mappings:~~
	~~"#bitlair":~~
	~~roomIds: ["!CtsqcBxtLmYfkJfVSk:matrix.bitlair.nl"]~~
	matrixClients:		matrixClients:
	userTemplate: "@smurfnet_$NICK"		userTemplate: "@smurfnet_$NICK"
Regel 132:		Regel 133:
	joinAttempts: -1		joinAttempts: -1
	ircClients:		ircClients:
	nickTemplate: "$~~USERID~~"		nickTemplate: "$LOCALPART"
	allowNickChanges: true		allowNickChanges: true
	maxClients: 100		maxClients: 100
Regel 140:		Regel 141:
	lineLimit: 3		lineLimit: 3

	matrix_prometheus_enabled: ~~true~~		matrix_prometheus_enabled: false

	matrix_prometheus_node_exporter_enabled: ~~true~~		matrix_prometheus_node_exporter_enabled: false

	matrix_grafana_enabled: ~~true~~		matrix_grafana_enabled: false

	matrix_grafana_anonymous_access: true		matrix_grafana_anonymous_access: true
Regel 154:		Regel 155:

	# Changing the password subsequently won't work.		# Changing the password subsequently won't work.
	matrix_grafana_default_admin_password: "~~GEHEIM~~"</nowiki>		matrix_grafana_default_admin_password: "mooi niet"

			matrix_synapse_ext_password_provider_rest_auth_enabled: true
			# matrix-ma1sd is the hostname of the ma1sd Docker container
			matrix_synapse_ext_password_provider_rest_auth_endpoint: "http://matrix-ma1sd:8090"

			matrix_ma1sd_configuration_extension_yaml: \|
			ldap:
			enabled: true
			connection:
			host: ldap.bitlair.nl
			tls: true
			port: 636
			baseDNs: ['OU=Members,DC=bitlair,DC=nl']
			bindDn: cn=matrix,ou=System,dc=bitlair,dc=nl
			bindPassword: nice try
			attribute:
			uid:
			type: 'uid'
			value: 'uid'
			name: 'uid'
			threepid:
			email:
			- 'mail'
			logging:
			root: error # default level for all loggers (apps and thirdparty libraries)
			app: warn # logt anders realnames (CN) naar journalctl
			requests: false # log request and response</nowiki>

	=== iptables ===		=== iptables ===

Sam: updaten naar huidige situatie

2021-12-04T08:24:50Z

updaten naar huidige situatie

← Oudere versie		Versie van 4 dec 2021 08:24
Regel 10:		Regel 10:
	IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.		IRC-chat(s) laagdrempeliger te maken. Niet iedereen heeft immers een bouncer/bak om irissi op te draaien, of kennis/tijd/zin om zoiets op te zetten.

	~~Op dit moment~~ is ~~de inhoud van de wikipagina alleen nuttig~~ voor ~~het bestuur~~ (~~of mensen aangewezen daardoor~~)~~, maar kan op een later moment gewijzigd worden om informatie te geven voor eindgebruikers~~.		Je kan inloggen met je LDAP-account. Let wel dat de server nog in testfase is, dus geen garanties voor (goede) werking.

	De 'realm' van de Matrix-server is ~~matrix.~~bitlair.nl, ~~dit omdat bitlair.nl gebruiken (en dus~~ op ~~bitlair.nl delegeren dmv SRV-record of .well-known) vereist dat de HS een geldig certificaat voor bitlair.nl heeft. Waar in docs van het ansible-playbook wordt gerefereerd aan DOMAIN is dat dus~~ matrix.bitlair.nl.		De 'realm' van de Matrix-server is bitlair.nl, de homeserver staat op matrix.bitlair.nl

	== Gebruik ==		== Gebruik ==
	* Log in met Element web (de de-facto web client voor Matrix, wordt by default geinstalleerd met het ansible playbook) op ~~matrix~~.bitlair.nl		* Log in met Element web (de de-facto web client voor Matrix, wordt by default geinstalleerd met het ansible playbook) op element.bitlair.nl
	* OF gebruik een andere matrix-client en stuur die naar ~~matrix.~~matrix.bitlair.nl		* OF gebruik een andere matrix-client en stuur die naar matrix.bitlair.nl
	* Join ~~#smurfnet_~~#bitlair:~~matrix.~~bitlair.nl om in de bridge naar #bitlair te komen		* Join #bitlair:bitlair.nl om in de bridge naar #bitlair te komen

	== Configuratie ==		== Configuratie ==

Sam: updateje

2021-11-17T14:11:11Z

updateje

← Oudere versie		Versie van 17 nov 2021 14:11
Regel 31:		Regel 31:

	matrix_ssl_retrieval_method: lets-encrypt		matrix_ssl_retrieval_method: lets-encrypt
	~~# snakeoil tot cname er is~~
	~~matrix_ssl_retrieval_method: manually-managed~~

	matrix_ssl_lets_encrypt_support_email: bestuur@bitlair.nl		matrix_ssl_lets_encrypt_support_email: bestuur@bitlair.nl
Regel 126:		Regel 124:
	initial: true		initial: true
	incremental: true		incremental: true
			mappings:
			"#bitlair":
			roomIds: ["!CtsqcBxtLmYfkJfVSk:matrix.bitlair.nl"]
	matrixClients:		matrixClients:
	userTemplate: "@smurfnet_$NICK"		userTemplate: "@smurfnet_$NICK"
Regel 133:		Regel 134:
	nickTemplate: "$USERID"		nickTemplate: "$USERID"
	allowNickChanges: true		allowNickChanges: true
	maxClients: 1		maxClients: 100
	idleTimeout: 0		idleTimeout: 0
	reconnectIntervalMs: 5000		reconnectIntervalMs: 5000

Sam: dat limiet was een snafu van mij, niet van smurfnet

2021-11-17T14:02:39Z

dat limiet was een snafu van mij, niet van smurfnet

← Oudere versie		Versie van 17 nov 2021 14:02
Regel 13:		Regel 13:

	De 'realm' van de Matrix-server is matrix.bitlair.nl, dit omdat bitlair.nl gebruiken (en dus op bitlair.nl delegeren dmv SRV-record of .well-known) vereist dat de HS een geldig certificaat voor bitlair.nl heeft. Waar in docs van het ansible-playbook wordt gerefereerd aan DOMAIN is dat dus matrix.bitlair.nl.		De 'realm' van de Matrix-server is matrix.bitlair.nl, dit omdat bitlair.nl gebruiken (en dus op bitlair.nl delegeren dmv SRV-record of .well-known) vereist dat de HS een geldig certificaat voor bitlair.nl heeft. Waar in docs van het ansible-playbook wordt gerefereerd aan DOMAIN is dat dus matrix.bitlair.nl.

	~~'''Let op:''' Smurfnet staat op moment van schrijven van de matrix server maar 1 conn tegelijk toe. Zou niet de bedoeling zijn, wordt aan gewerkt. De bridge niet gebruiken dus (behalve voor tests).~~

	== Gebruik ==		== Gebruik ==

Sam op 17 nov 2021 om 10:23

2021-11-17T10:23:26Z

← Oudere versie		Versie van 17 nov 2021 10:23
Regel 177:		Regel 177:

	== Onderhoudstaken ==		== Onderhoudstaken ==

			=== Updaten (of wijzigen van config van) playbook ===

			<code>/opt/matrix-ansible-playbook/update-playbook-and-start-all.sh</code>

			Draai dit als root. Pullt playbook, update het (met de lokale ansible install dus) en restart docker-iptables zodat de SNAT regels weer bovenaan staan. Staat als cronjob iedere 2 weken:

			<code>0 2 1,14 * * /opt/matrix-ansible-playbook/update-playbook-and-start-all.sh >/dev/null 2>&1</code>

	=== Adminpanel ===		=== Adminpanel ===