Snel antwoord
Hoe host ik een Matrix-server op een VPS?
Om een Matrix-server op een VPS te hosten, installeert u Synapse uit de apt-repository van Matrix.org, geeft u het een PostgreSQL-database en zet u een HTTPS-reverse proxy op poort 443 voor zijn poort 8008. Het Gloam-plan van Gloamport, 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic tegen $8.25 per maand bij 12 maanden, is daarop afgestemd.
Wat houdt een Synapse-installatie in?
| Onderdeel | Instelling | Waarom |
|---|---|---|
| Servernaam | Het domein in gebruikers-ID's, bijvoorbeeld example.com; kan later niet worden gewijzigd | Federatie-identiteit |
| Pakket | matrix-synapse-py3 van packages.matrix.org | Het eigen pakket van Debian is niet beschikbaar voor Debian 13 en ouder |
| Configuratie-overschrijvingen | /etc/matrix-synapse/conf.d/ | Pakketupgrades vragen niet of uw configuratie vervangen moet worden |
| Client- en federatielistener | HTTP op localhost:8008 achter een proxy | De proxy beëindigt HTTPS |
| Database | PostgreSQL (psycopg2) | De documentatie noemt SQLite alleen geschikt voor testen |
| Poorten | 443 voor clients; 8448 voor federatie tenzij doorverwezen naar 443 | Beide moeten vanaf het internet bereikbaar zijn |
| Plan | Gloam: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic | Gloamport-planlijst |
Prijzen gecontroleerd op
Wat heeft u nodig voordat u een Matrix-server installeert?
U heeft een domeinnaam nodig die u beheert en een VPS met een publiek IPv4-adres. Het domein weegt zwaarder dan de server: de Synapse-documentatie zegt dat de servernaam het domeindeel van elk gebruikers-ID is en dat die later niet meer gewijzigd kan worden. Kies hem dus vóór u installeert.
Een Gloamport-VPS heeft op elk plan één IPv4 en een IPv6 /64, dus DNS-records kunnen er rechtstreeks naar wijzen. Een domein wordt hier niet verkocht; koop het waar u wilt en maak een A-record voor de hostnaam die u gaat gebruiken. Alleen Linux: Debian-, Ubuntu-, AlmaLinux- en Rocky Linux-images. Geen Windows. Reken naast de installatie zelf ongeveer een uur voor DNS en het certificaat.
Synapse installeren op Debian 13 of Ubuntu 24.04
De commando's volgen de officiële Synapse-documentatie. Voer ze uit als root of met sudo.
Wijs DNS naar de VPS
Maak een A-record voor matrix.example.com met het adres van de VPS (en een AAAA-record als u IPv6 gebruikt). Wacht tot het resolvet voordat u om een certificaat vraagt.
Voeg de apt-repository van Matrix.org toe
Download de ondertekeningssleutel, voeg de regel van de repository toe en voer apt update uit, zoals in het eerste codeblok. De documentatie geeft de sleutel-fingerprint AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058; vergelijk die met gpg voordat u de sleutel vertrouwt.
Installeer matrix-synapse-py3
Voer apt install matrix-synapse-py3 uit en stel de servernaam in wanneer daarom wordt gevraagd. Wijzig instellingen alleen via bestanden in /etc/matrix-synapse/conf.d/.
Maak de PostgreSQL-database aan
Installeer PostgreSQL en de bibliotheek libpq5, maak daarna de gebruiker en de database aan met de commando's in het tweede codeblok, en wijs Synapse ernaar met het databaseblok dat daar staat.
Zet een reverse proxy ervoor
Installeer een webserver, haal een certificaat voor de hostnaam op, en stuur /_matrix en /_synapse/client door naar localhost:8008 zoals in het derde codeblok. Zet x_forwarded: true op de 8008-listener.
Maak uw gebruiker aan en test
Stel een registration_shared_secret in, herstart Synapse, voer register_new_matrix_user uit en log daarna in via een Matrix-client met het adres van uw homeserver.
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-py3sudo apt install postgresql libpq5
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
# /etc/matrix-synapse/conf.d/database.yaml
database:
name: psycopg2
args:
user: synapse_user
password: CHANGE_ME
dbname: synapse
host: localhost
cp_min: 5
cp_max: 10# nginx: inside a server block that listens on 443 ssl for matrix.example.com
location ~ ^(/_matrix|/_synapse/client) {
proxy_pass http://localhost:8008;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 50M;
}
# Synapse listener on port 8008, in homeserver.yaml or a conf.d file
listeners:
- port: 8008
type: http
x_forwarded: true
bind_addresses: ['127.0.0.1']
resources:
- names: [client, federation]# conf.d/registration.yaml (a random value, kept secret)
registration_shared_secret: "RANDOM_VALUE"
sudo systemctl restart matrix-synapse
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yamlHoeveel server heeft een Matrix-homeserver nodig?
Een privé-homeserver voor enkele mensen past op een middelgroot plan; federatie naar grote openbare kamers is wat de belasting doet groeien. Wij hebben Synapse niet getest en geven geen gebruikersaantallen. Gloamport noemt Gloam als plan voor Een Matrix-server, Vaultwarden en SearXNG samen: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic, $8.25 per maand bij de termijn van 12 maanden en $16.50 bij één maand.
Voor een teamchat met veel kamers wordt Night (4 vCPU, 8 GB RAM, 160 GB NVMe, 8 TB traffic, $13.50 per maand bij de termijn van 12 maanden) genoemd voor Een drukke relay, een teamchatserver of meerdere diensten.
Heeft federatie poort 8448 nodig?
Nee, federatie kan via poort 443 lopen als u die delegeert. De reverse-proxypagina van Synapse zegt dat er bij delegatie via het antwoord .well-known/matrix/server geen poort 8448 open hoeft en dat federatie 443 gebruikt. Zonder delegatie is de standaard federatiepoort 8448, dus open die in de firewall en voeg een tweede serverblok toe dat daarop luistert.
Clients vinden uw server via een bestand /.well-known/matrix/client op https://uw-servernaam/.well-known/matrix/client, dat de homeserver noemt in m.homeserver met zijn base_url. Browserclients hebben ook een CORS-header nodig, en de public_baseurl van Synapse moet dezelfde URL hebben. Gebruik de servernaam op het kale domein alleen als u dat bestand daar kunt serveren.
Hoe houdt u een zelf gehoste Matrix-server veilig?
Maak een back-up van de ondertekeningssleutel, de database en de mediaopslag, en houd het host bijgewerkt. De documentatie waarschuwt dat de ondertekeningssleutels bewaard moeten worden, omdat andere servers erop vertrouwen. Berichten in kamers zonder end-to-end-versleuteling staan leesbaar in de database op uw VPS, dus schijfversleuteling is de moeite waard; Kan ik een VPS-schijf versleutelen met LUKS? legt uit wat schijfversleuteling wel en niet beschermt.
Geen enkel plan bevat back-ups: bewaar zelf een kopie van alles wat u niet kunt missen. Volgens het onderzoek van Gloamport naar 10 november 2026 vragen 28 van de 49 aanbieders bij aanmelding geen identiteitsbewijs, dus de VPS kan worden gekocht zonder documenten af te geven. De beveiliging van de server blijft wel van u: alleen SSH met sleutel, zoals in Hoe verhard ik SSH op een nieuwe VPS?.
Samengevat
- Synapse wordt geïnstalleerd vanaf packages.matrix.org als matrix-synapse-py3.
- De servernaam is permanent; kies eerst het domein.
- Gebruik PostgreSQL; de documentatie noemt SQLite alleen geschikt voor testen.
- Stuur /_matrix en /_synapse/client door naar localhost:8008 achter HTTPS.
- Delegatie laat federatie poort 443 gebruiken in plaats van 8448.
- Gloam, $8.25 per maand bij 12 maanden, is het passende plan.
- Maak back-ups van de ondertekeningssleutels, de database en de media; geen enkel plan bevat back-ups.
Een Matrix-server hosten: veelgestelde vragen
Heb ik een domeinnaam nodig voor Matrix?
Ja. De servernaam maakt deel uit van elk gebruikers-ID en wordt bij de installatie vastgelegd. Ze kan daarna niet meer worden gewijzigd, dus registreer of kies het domein voordat u installeert.
Waarom geen SQLite gebruiken?
De Synapse-documentatie zegt dat SQLite alleen geschikt is voor testen en niet in productie gebruikt mag worden. Vrijwel alle installaties moeten PostgreSQL gebruiken.
Waar zet ik mijn eigen instellingen?
In bestanden onder /etc/matrix-synapse/conf.d/. De documentatie raadt dit aan, zodat een pakketupgrade niet vraagt of uw configuratiebestand vervangen moet worden.
Hoe maak ik het eerste account aan?
Voer register_new_matrix_user -c uit op de homeserverconfiguratie nadat Synapse draait. Het gebruikt het registration_shared_secret, waarmee iedereen die het kent accounts kan aanmaken, ook beheerders.
Kan ik Matrix naast andere diensten draaien?
Ja, op een Gloam- of groter plan. Vaultwarden en SearXNG zijn klein naast die server; zie de gids over zelf hosten van Vaultwarden.
Bronnen (3)
- Synapse-documentatie: installatie-instructies — Element / Matrix.org Foundation (checked 2026-11-10)
- Synapse-documentatie: een reverse proxy gebruiken met Synapse — Element / Matrix.org Foundation (checked 2026-11-10)
- Synapse-documentatie: PostgreSQL gebruiken — Element / Matrix.org Foundation (checked 2026-11-10)