SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor · Bijgewerkt 2026-10-30

Matrix Synapse zelf hosten op een VPS

Lees wat een Synapse-homeserver op Ubuntu 24.04 LTS nodig heeft: Postgres, mediabehoud, registratiebeveiliging en back-ups van configuratie en media.

Wat er nodig is om een Matrix Synapse homeserver in de lucht te houden

Matrix Synapse is eenvoudig te installeren, maar wordt ook snel verwaarloosd. De installatie bestaat uit één apt repository, één configuratiebestand, één reverse proxy-blok en één DNS-record. Het gedurende een jaar gezond houden van de homeserver vereist ander werk: een volwaardige database, een media store die wordt opgeschoond, registratie die niet toegankelijk is voor vreemden, en een back-up die beide helften van de server veiligstelt.

Deze handleiding richt zich op Ubuntu 24.04 LTS en installeert Synapse vanuit de matrix.org apt repository; dit is de pakketbron die het Synapse-project onderhoudt voor Debian en Ubuntu. Pakketversies wijzigen elke paar weken, daarom wordt hier geen versienummer genoemd. Elk pad en elke optie hieronder is afkomstig uit de actuele Synapse-documentatie.

Dimensionering: wat u daadwerkelijk krijgt met 1 vCPU en 2 GB RAM

Gepubliceerde pagina's over dimensionering, bijgewerkt tot augustus 2026, adviseren doorgaans 1 vCPU en 2 GB RAM voor een Synapse-homeserver. Dit is een eerlijk advies voor één scenario: een privéserver met enkele gebruikers, kleine ruimtes en geen drukke openbare ruimtes. De documentatie van Synapse is duidelijk over het andere scenario. Er wordt gevraagd om "minimaal 1 GB vrij RAM-geheugen als u wilt deelnemen aan grote openbare ruimtes zoals #matrix:matrix.org". Dit is vrij RAM-geheugen, bovenop wat Python, Postgres en de kernel verbruiken.

Eén ruimte kan uw dimensionering veranderen vanwege de manier waarop deelname werkt. Wanneer een lokale gebruiker deelneemt aan een ruimte, wordt uw homeserver een volledige deelnemer in die ruimte. De server ontvangt elk evenement van elke andere server in die ruimte, verifieert de handtekening van elk evenement en slaat de status van de ruimte lokaal op. Een grote openbare ruimte heeft duizenden leden verspreid over honderden servers, dus uw systeem voert dit werk continu uit, ongeacht of uw gebruiker de ruimte ooit nog opent. Het later verlaten van de ruimte verwijdert de geschiedenis die u al heeft opgeslagen niet.

Het meeste RAM-geheugen van Synapse wordt gebruikt voor caches. De caches-sectie bevat een global_factor die alle caches tegelijk schaalt, en de SYNAPSE_CACHE_FACTOR-omgevingsvariabele stelt hetzelfde in. Het verhogen hiervan verbruikt RAM om databasequery's te vermijden. Het verlagen ervan verbruikt CPU en Postgres-tijd om RAM te besparen. Postgres heeft zelf ook geheugen nodig, dus op een systeem met 2 GB concurreren beide om dezelfde megabytes.

Twee praktische regels voor een klein abonnement. Voeg swap toe: swap maakt Synapse niet snel, maar het voorkomt dat de kernel het proces beëindigt tijdens een grote deelname. Houd daarnaast vanaf de eerste week de schijfruimte in de gaten, omdat de twee zaken die onbeperkt groeien de media-opslag en de tabellen met ruimtestatussen zijn, en beide bevinden zich op de schijf.

Waarom Postgres, en waarom SQLite niet langer volstaat

Het Debian-pakket start standaard met SQLite. Dit is prima voor een eerste opstart, maar ongeschikt voor een server die door anderen wordt gebruikt. SQLite staat slechts één schrijfactie tegelijk toe. Federatieverkeer en clientverzoeken schrijven op hetzelfde moment, waardoor een eenvoudig verzoek moet wachten op een trager proces. Het symptoom dat uw gebruikers rapporteren is dat de applicatie willekeurig enkele seconden lijkt te hangen.

De tweede reden is structureel. De worker-processen van Synapse zijn de ondersteunde methode om meer dan één CPU-kern te benutten, en deze workers vereisen Postgres. Bij SQLite blijven betekent dat u zowel het upgradepad als de prestaties opgeeft.

Migreren op een later moment wordt ondersteund, maar dit vereist downtime. Voer de migratie daarom uit voordat u gebruikers heeft. Synapse levert synapse_port_db mee, waarmee een SQLite-database naar een voorbereide Postgres-database wordt gekopieerd:

synapse_port_db --sqlite-database homeserver.db --postgres-config homeserver-postgres.yaml

Als u de database liever in een container naast Synapse draait, vindt u de afwegingen in het draaien van uw database in Docker of op de host.

Synapse installeren op Ubuntu 24.04

sudo apt install -y lsb-release wget apt-transport-https
sudo 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" | sudo tee /etc/apt/sources.list.d/matrix-org.list
sudo apt update
sudo apt install matrix-synapse-py3

Op Ubuntu 24.04 print lsb_release -cs de waarde noble, en de matrix.org-repository publiceert een noble-suite. Gebruik niet het matrix-synapse-pakket uit het eigen archief van Ubuntu. Het Synapse-project verzoekt u dit niet te doen, omdat deze builds achterlopen op de releases en bekende beveiligingslekken bevatten.

Het installatieprogramma vraagt om een servernaam en schrijft het antwoord naar /etc/matrix-synapse/conf.d/server_name.yaml. Beantwoord dit zorgvuldig. server_name is het gedeelte na de dubbele punt in elke gebruikers-ID (@alice:example.com) en het is ingebed in elke kamer die uw server aanmaakt. Het later wijzigen hiervan verplaatst niets: het creëert een andere homeserver. Gebruik uw kale domein, example.com, zelfs wanneer Synapse zelf op matrix.example.com zal draaien. Delegatie verbindt de twee, en dat is het onderwerp van de volgende sectie.

Het pakket voert Synapse uit als de matrix-synapse-gebruiker, bewaart de data onder /var/lib/matrix-synapse, en leest /etc/matrix-synapse/homeserver.yaml gevolgd door elk bestand in /etc/matrix-synapse/conf.d/. Plaats uw eigen instellingen in kleine bestanden in conf.d. Upgrades van het pakket laten deze ongemoeid.

sudo systemctl restart matrix-synapse
systemctl status matrix-synapse
sudo journalctl -u matrix-synapse -n 100 --no-pager

Een gezonde start brengt de listeners online en blijft daarna stil. De systemd-unit herstart de service enkele seconden na elke afsluiting, dus een configuratie die Synapse weigert, toont zich als een unit die in een lus opstart en weer stopt. De laatste regels van de journal benoemen de sleutel die werd geweigerd.

Synapse koppelen aan Postgres

sudo apt install -y postgresql
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

De locale is niet louter cosmetisch. Synapse weigert te starten met een database die is aangemaakt met andere COLLATE- en CTYPE-waarden, tenzij u allow_unsafe_locale instelt in de databaseconfiguratie. De gedocumenteerde reparatiemethode achteraf is een dump en een herstel naar een correct aangemaakte database. Maak deze de eerste keer direct goed aan.

database:
  name: psycopg2
  txn_limit: 10000
  args:
    user: synapse_user
    password: secretpassword
    dbname: synapse
    host: localhost
    port: 5432
    cp_min: 5
    cp_max: 10

Behoud exact één database:-sleutel in al uw configuratiebestanden. Vervang het SQLite-blok binnen homeserver.yaml in plaats van een tweede kopie toe te voegen onder conf.d, zodat er nooit onduidelijkheid bestaat over welke configuratie actief is. Start opnieuw op en controleer vervolgens of Synapse daadwerkelijk op Postgres draait:

sudo -u postgres psql synapse -c "SELECT count(*) FROM users;"

Een getal betekent dat Synapse het schema in deze database heeft opgebouwd. Een foutmelding over een ontbrekende relatie betekent dat er nog steeds naar het SQLite-bestand wordt geschreven; de configuratie die u heeft bewerkt, is dus niet degene die wordt ingelezen.

Reverse proxy, TLS en de behoeften voor .well-known-bestanden voor federatie

Synapse luistert op onversleuteld HTTP op poort 8008, gebonden aan localhost. TLS en de publieke poort behoren toe aan een reverse proxy die ervoor staat.

listeners:
- port: 8008
  tls: false
  type: http
  x_forwarded: true
  bind_addresses:
  - '::1'
  - '127.0.0.1'
  resources:
  - names:
    - client
    - federation
    compress: false

x_forwarded: true instrueert Synapse om de X-Forwarded-For-header die de proxy instelt te vertrouwen. Zonder deze instelling lijkt elke client afkomstig van 127.0.0.1, waardoor rate limiting één extreem actieve lokale gebruiker ziet en iedereen tegelijkertijd beperkt.

location ~ ^(/_matrix|/_synapse/client) {
    proxy_pass http://localhost:8008;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $host:$server_port;
    client_max_body_size 50M;
    proxy_http_version 1.1;
}

De Synapse-documentatie geeft één waarschuwing over dit blok die gebruikers dagen aan werk kan kosten. Voeg geen pad toe, zelfs geen enkele /, na de poort in proxy_pass. nginx normaliseert in dat geval de URI, wat de bytes verandert die de verzendende server heeft ondertekend. Hierdoor falen federatieverzoeken bij de verificatie van de handtekening, terwijl gewone clientverzoeken blijven werken.

client_max_body_size moet minstens zo groot zijn als de max_upload_size van Synapse. Als nginx het kleinere getal hanteert, worden uploads die daarboven liggen door nginx geweigerd met 413 Request Entity Too Large voordat Synapse ze ooit ziet; er is dan geen Synapse-logregel die de fout verklaart.

Volg voor het certificaat zelf Certbot en Let's Encrypt op Ubuntu 24.04. Als de keuze voor een proxy nog niet is gemaakt, behandelt de vergelijking van reverse proxies welke proxy het TLS-werk voor u uit handen neemt.

Delegatie is wat ervoor zorgt dat server_name gelijk blijft aan example.com terwijl Synapse draait op matrix.example.com. Serveer twee bestanden vanaf het hoofddomein:

location /.well-known/matrix/server {
    default_type application/json;
    return 200 '{"m.server": "matrix.example.com:443"}';
}

location /.well-known/matrix/client {
    default_type application/json;
    add_header Access-Control-Allow-Origin '*';
    return 200 '{"m.homeserver": {"base_url": "https://matrix.example.com"}}';
}

Het serverbestand vertelt andere homeservers waar ze federatieverkeer naartoe moeten sturen; dit is hoe federatie over poort 443 verloopt in plaats van de standaardpoort 8448. Het clientbestand vertelt Matrix-clients welke URL de backend vormt voor @alice:example.com. De Access-Control-Allow-Origin-header is van belang bij het clientbestand omdat browsergebaseerde clients dit cross-origin ophalen; zonder deze header blokkeert de browser het antwoord en meldt de client dat deze uw homeserver niet kan vinden.

Beide bestanden moeten via geldige TLS worden geserveerd vanaf example.com zelf. Controleer ze en verifieer vervolgens wat de buitenwereld ziet:

curl -s https://example.com/.well-known/matrix/server
curl -s https://matrix.example.com/_matrix/federation/v1/version

Het eerste commando retourneert de JSON die u heeft geschreven. Het tweede retourneert een JSON-object met de serverimplementatie en de versie daarvan, wat bewijst dat de proxy Synapse bereikt via het federatiepad. Voer daarna het domein in bij de Matrix federation tester op https://federationtester.matrix.org, die dezelfde route volgt als een echte externe server.

Federeren of niet federeren: neem die beslissing bewust

Federatie is de kern van Matrix, maar brengt ook de meeste kosten met zich mee. Een federerende homeserver accepteert verbindingen van servers die u niet kent, ontvangt hun events, cachet hun media en slaat state op voor elke room waarmee uw gebruikers werken. Dat is een keuze voor het dreigingsmodel, geen standaardinstelling.

Schakel federatie in wanneer uw gebruikers mensen op andere homeservers moeten kunnen bereiken, of wanneer een draagbare identiteit de reden is waarom u voor Matrix hebt gekozen. Schakel federatie niet in wanneer de server voor één team bestaat en alle accounts daarop van u zijn. Een gesloten server slaat minder gegevens op, ontvangt minder verkeer en is veel minder interessant voor misbruik.

Synapse gebruikt een allowlist wanneer u federatie wilt beperken in plaats van uitschakelen:

federation_domain_whitelist:
- lon.example.com
- nyc.example.com

De documentatie adviseert ook om de federatielistener met de firewall af te schermen, zodat ongewenst verkeer al op netwerkniveau wordt gestopt en niet pas in Python. Schakel federatie volledig uit door dezelfde optie op een lege lijst in te stellen:

federation_domain_whitelist: []

De configuratiehandleiding van Synapse noemt de lege lijst de aanbevolen manier om federatie uit te schakelen. Het helpcentrum van Element geeft dezelfde instelling. Federatie is standaard ingeschakeld, omdat elke server wordt toegestaan wanneer u de optie niet instelt. Het verwijderen van federation uit de listener-resources-lijst, het niet publiceren van /.well-known/matrix/server en het gesloten houden van poort 8448 houden alleen inkomend federatieverkeer bij Synapse weg. Ze voorkomen niet dat uw server uitgaande federatieverzoeken doet. Beschouw deze maatregelen en de firewall daarom als extra beveiligingslagen boven op de lege lijst, nooit als vervanging daarvan.

Als u Matrix oorspronkelijk voor privéteamchat wilde gebruiken en federatie nooit onderdeel van het plan was, vergelijk dan de beheerkosten met de andere zelfgehoste Slack-alternatieven voordat u zich aan Synapse committeert. Met Rocket.Chat op Docker Compose kunt u teamchat op een kleinere machine aanbieden, omdat het nooit de room-state van een andere organisatie hoeft op te slaan.

De mediarepository die ongemerkt de schijf vult

Bestanden die uw eigen gebruikers uploaden, blijven permanent op uw schijf staan. Bestanden die gebruikers op andere homeservers plaatsen, worden naar uw schijf opgehaald en daar in de cache opgeslagen zodra een van uw clients ze weergeeft. Synapse genereert ook miniaturen voor afbeeldingen, waardoor één foto meerdere bestanden oplevert. Standaard verloopt geen van deze bestanden automatisch.

Zoek de opslaglocatie en meet de omvang:

grep media_store_path /etc/matrix-synapse/homeserver.yaml
sudo du -sh /var/lib/matrix-synapse/media_store

Meet het pad dat uw eigen configuratie afdrukt. Het Debian-pakket bewaart de gegevens van Synapse onder /var/lib/matrix-synapse, dus de opslag bevindt zich daar normaal gesproken. Stel vervolgens een bewaarbeleid in conf.d in:

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

Lees deze twee regels zorgvuldig, omdat het om verschillende typen instellingen gaat. Beide meten de tijd sinds een bestand voor het laatst is gebruikt, niet sinds het is geüpload. remote_media_lifetime laat een cache verlopen. Alles wat deze instelling verwijdert, kan opnieuw worden opgehaald van de server die het bestand beheert. local_media_lifetime verwijdert uploads van uw eigen gebruikers permanent zodra niemand ze gedurende die periode heeft gebruikt. Een team dat documenten in chat deelt en verwacht deze volgend jaar terug te vinden, raakt ze kwijt. Veel servers stellen alleen de waarde voor externe media in.

Voor een eenmalige opschoning gebruikt de admin-API een Unix-tijdstempel in milliseconden:

BEFORE_TS=$(date -d '30 days ago' +%s%3N)
curl -X POST -H "Authorization: Bearer $ADMIN_TOKEN" \
  "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$BEFORE_TS"

POST /_synapse/admin/v1/purge_media_cache verwijdert gecachte externe media die vóór dat tijdstempel voor het laatst zijn gebruikt. POST /_synapse/admin/v1/media/delete?before_ts=<ms> verwijdert lokale media volgens dezelfde regel. Voer eerst de opschoning van externe media uit en meet daarna opnieuw. Op een server die federation gebruikt, neemt de cache met externe media meestal het grootste deel in beslag.

Twee instellingen beïnvloeden dezelfde schijfruimte. max_upload_size begrenst één upload en moet overeenkomen met client_max_body_size in nginx. url_preview_enabled: true zorgt ervoor dat uw server externe pagina's ophaalt, zodat clients linkvoorbeelden kunnen weergeven. Dat kost bandbreedte en slaat miniaturen op van inhoud die niemand naar uw server heeft geüpload.

Sluit registratie af voordat iemand uw homeserver vindt

Scanners vinden een open homeserver binnen enkele dagen. Zodra accounts vrij aan te maken zijn, wordt uw server een bron van spam in elke ruimte waarmee deze federeert, en blokkeren de beheerders aan de andere kant uw volledige domein. Die reputatieschade duurt langer dan het opschonen, omdat de blokkeerlijsten handmatig worden onderhouden.

Synapse wordt gesloten geleverd. enable_registration staat standaard op false en registration_requires_token staat standaard op false. Synapse weigert bovendien te starten met registratie ingeschakeld en zonder verificatiestap, tenzij u aanvullend enable_registration_without_verification: true instelt. Die weigering is bewust, dus schakel dit niet in om een opstartfout te verhelpen.

Maak de gewenste accounts handmatig aan:

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

Het script vraagt om de gebruikersnaam, het wachtwoord en of het account een serverbeheerder moet zijn. Het leest registration_shared_secret uit de configuratie die u meegeeft met -c. Als het meldt dat het een shared secret niet kan vinden, wijs -c dan naar het bestand waarin dit is opgeslagen.

Wanneer het handmatig aanmaken van accounts niet meer schaalt, zijn registratietokens de tussenoplossing. Een token is een tekenreeks die een nieuwe gebruiker moet opgeven tijdens de aanmelding, en elk token kan een limiet bevatten voor het aantal keer dat het bruikbaar is:

enable_registration: true
registration_requires_token: true
curl -X POST -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uses_allowed": 1}' \
  https://matrix.example.com/_synapse/admin/v1/registration_tokens/new

Laat token weg uit de body en Synapse genereert er een en geeft deze terug. GET /_synapse/admin/v1/registration_tokens toont elk token, inclusief tokens die zijn verlopen of verbruikt. Voeg ?valid=true toe om alleen de tokens te zien die nog werken. Beide aanroepen vereisen het access token van een serverbeheerdersaccount, dat u verkrijgt door in te loggen als de beheerder die u hierboven heeft aangemaakt.

Een organisatie die elders al accounts beheert, kan lokale wachtwoorden volledig overslaan, omdat Synapse het inloggen kan delegeren aan een OIDC (OpenID Connect)-provider, bijvoorbeeld Authentik als zelfgehoste SSO-provider. Nieuwe en vertrekkende gebruikers worden dan op één plek beheerd.

Een back-up waarmee u de server daadwerkelijk kunt herstellen

Een Synapse-back-up bestaat uit drie onderdelen. Als een back-up een van deze onderdelen mist, herstelt u een server die onbruikbaar is.

  • De Postgres-database, die alle events, accounts en rooms bevat.
  • De media store-map, die alle geüploade bestanden bevat.
  • /etc/matrix-synapse, die uw configuratie en de signing key van de server bevat.

De signing key is het onderdeel dat vaak wordt vergeten. Dit is de private key waarmee uw homeserver events ondertekent, en waartegen externe servers de events verifiëren met de bijbehorende public key. Voer grep signing_key_path /etc/matrix-synapse/homeserver.yaml uit om te zien waar deze zich bevindt. Als u deze verliest, herstelt u een server die niet kan bewijzen dat het dezelfde server is die uw rooms al kennen.

sudo -u postgres pg_dump --format=custom --file=/var/backups/synapse-$(date +%F).dump synapse
sudo tar czf /var/backups/synapse-etc-$(date +%F).tgz -C /etc matrix-synapse

Maak eerst een dump van de database en kopieer daarna de media store. Mediabestanden worden eenmalig geschreven en via een ID gerefereerd. Een kopie van de media die na de dump wordt gemaakt, kan daarom alleen extra bestanden bevatten, maar nooit ontbrekende. De omgekeerde volgorde kan ertoe leiden dat de herstelde database verwijst naar een bestand dat nooit in uw back-up is opgenomen.

Verplaats alle drie de onderdelen van de VPS. restic met off-site snapshots sluit hier goed bij aan, omdat de media store het grootste deel is en nauwelijks verandert tussen back-ups. Deduplicatie houdt elke snapshot daardoor klein.

Oefen vervolgens het herstel, want een back-up die u nooit heeft teruggezet, is slechts een hypothese. Bouw een tweede VPS, installeer hetzelfde pakket, herstel de configuratie, maak de database aan met dezelfde encoding en locale, pg_restore de dump erin, kopieer de media store terug en log in. Noteer hoe lang dit proces duurde. Dat getal is uw werkelijke hersteltijd.

Wanneer de state-tabellen groeien: compactie

Synapse slaat de roomstatus op als state groups. Op een server die federation gebruikt, wordt state_groups_state vaak het grootste object in de database. Meet dit voordat u iets wijzigt:

sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_database_size('synapse'));"
sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_total_relation_size('state_groups_state'));"

Als die ene tabel het grootste deel van uw database vormt, publiceert het project hiervoor een compressor: rust-synapse-compress-state. Deze herschrijft de hierarchie van state groups naar minder rijen, zonder de betekenis van de state van een room te wijzigen. De compressor is gebouwd met Rust:

sudo apt install -y build-essential libssl-dev pkg-config git
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git clone https://github.com/matrix-org/rust-synapse-compress-state.git
cd rust-synapse-compress-state/synapse_auto_compressor
cargo build --release
./target/release/synapse_auto_compressor -p postgresql://synapse_user:secretpassword@localhost/synapse -c 500 -n 100

-c bepaalt op hoeveel state groups tegelijk wordt gewerkt. -n bepaalt hoeveel van die chunks deze uitvoering verwerkt. De automatische compressor registreert hoe ver hij is gekomen. De volgende uitvoering gaat daardoor verder vanaf dat punt, waardoor u deze veilig kunt inplannen. In de README van het project staat dat state_groups en state_groups_state alleen toevoegingen bevatten en dat wijzigingen binnen transacties worden uitgevoerd. Daarom is de SQL veilig toe te passen terwijl Synapse actief is. Deze verklaring staat in de inleiding van de README en niet in de eigen sectie van de automatische compressor. Maak daarom toch een back-up van de database voordat u deze voor het eerst uitvoert.

Een detail van Postgres verrast hier veel mensen. Door rijen te verwijderen komt de ruimte beschikbaar voor hergebruik door Postgres, maar niet voor het bestandssysteem. Daardoor verandert df mogelijk helemaal niet na een grote compactie. VACUUM FULL geeft die ruimte terug aan het bestandssysteem. Hiervoor is een exclusieve vergrendeling op de tabel nodig en vrije schijfruimte die ongeveer gelijk is aan de omvang van de tabel. Plan dit daarom als onderhoud in en voer het niet zomaar uit.

Controles die de status van de server verifiëren

systemctl status matrix-synapse
curl -s https://example.com/.well-known/matrix/server
curl -s https://matrix.example.com/_matrix/federation/v1/version
sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_database_size('synapse'));"
sudo du -sh /var/lib/matrix-synapse/media_store

Gezond betekent dat de unit actief is en niet herstart, het delegatiebestand uw m.server-waarde retourneert, het federatie-versie-eindpunt JSON retourneert en de twee groottegetallen vergeleken kunnen worden met die van vorige maand. De groottes zijn de controle die mensen vaak overslaan, en een volle schijf is de fout die een Synapse-server zonder waarschuwing platlegt: een vol volume voorkomt dat Postgres kan schrijven, waarna Synapse elk verzoek dat de database raadpleegt, afwijst.

FAQ

Hoeveel RAM heeft een Matrix Synapse-server nodig?

Voor een privé-homeserver met enkele gebruikers, kleine rooms en geen grote openbare rooms is 2 GB werkbaar. Dat is ook wat de meeste gepubliceerde pagina's met sizing-adviezen aanraden vanaf August 2026. De Synapse-documentatie vraagt daarnaast om ten minste 1 GB vrij RAM als uw gebruikers grote openbare rooms joinen, zoals #matrix:matrix.org. Uw server slaat in dat geval de state van die room op en verwerkt het verkeer ervan voortdurend. Voeg swap toe aan een plan met 2 GB, zodat één grote join niet tot gevolg kan hebben dat de kernel het proces beëindigt.

Moet ik PostgreSQL gebruiken in plaats van SQLite?

Na meer dan enkele gebruikers: ja. SQLite staat slechts één writer tegelijk toe. Federationverkeer en clientverzoeken blokkeren elkaar daardoor onder belasting, en verzoeken blijven soms secondenlang hangen. De workerprocessen van Synapse, de ondersteunde manier om meer dan één CPU-core te gebruiken, vereisen Postgres. Een latere migratie werkt met synapse_port_db en veroorzaakt downtime. Maak de database daarom aan met --encoding=UTF8 --locale=C --template=template0 voordat u gebruikers heeft.

Waarom blijft het schijfgebruik van mijn Synapse groeien?

Het gaat om één directory en één tabel. De media store bewaart elk bestand dat is geüpload naar rooms waarin uw server deelneemt. Daaronder vallen ook gecachte kopieën van media van externe gebruikers en gegenereerde thumbnails. Er verloopt niets totdat u media_retention instelt. De tabel state_groups_state groeit mee met de roomstatus op een server die federation gebruikt, en rust-synapse-compress-state verkleint de omvang ervan. Meet beide, met du -sh op uw media_store_path en met SELECT pg_size_pretty(pg_total_relation_size('state_groups_state'));, voordat u bepaalt welke u moet aanpakken.

Hoe voorkom ik dat onbekenden zich op mijn homeserver registreren?

Laat enable_registration op de standaardwaarde false staan en maak accounts aan met register_new_matrix_user. Wanneer dat niet meer schaalbaar is, stelt u enable_registration: true in samen met registration_requires_token: true en verstrekt u tokens die via POST /_synapse/admin/v1/registration_tokens/new zijn aangemaakt. Stel enable_registration_without_verification: true niet alleen in om de weigering van Synapse om te starten te onderdrukken. Een open homeserver wordt dan een bron van spam, waarna andere beheerders uw volledige domein kunnen blokkeren.

Moet mijn homeserver federation gebruiken?

Federation is een beslissing over blootstelling, geen standaardinstelling. Gebruik federation als uw gebruikers mensen op andere homeservers moeten kunnen bereiken. Schakel federation uit met federation_domain_whitelist: [] als de server één team bedient. Een server zonder federation slaat minder gegevens op, ontvangt minder verkeer en trekt veel minder misbruik aan. Daartussenin beperkt federation_domain_whitelist federation tot benoemde partnerdomeinen. De Synapse-documentatie raadt daarnaast aan de federation-listener met een firewall af te schermen, in plaats van alleen op die controle op de applicatielaag te vertrouwen.

Was dit artikel nuttig?

#matrix#synapse#self-hosting#postgresql#federation