Ja, een Raspberry Pi 4 kan Conduit draaien en het project publiceert ARM64-builds. Voor een kleine persoonlijke of gezinsserver zijn de belangrijkste configuratiekeuzes een 64-bits besturingssysteem, een permanente Matrix-servernaam, permanente opslag en werkende HTTPS-routering. Conduit beschrijft zichzelf momenteel als bèta, dus houd het up-to-date en ga er niet vanuit dat een Pi 4 een specifieke gebruikerscapaciteit ondersteunt; het project publiceert geen capaciteitsbenchmark voor de Raspberry Pi 4.
Is Conduit de juiste oplossing voor deze Raspberry Pi?
Conduit is een lichtgewicht Matrix-homeserver met RocksDB als aanbevolen database-backend. De officiële implementatiedocumentatie vermeldt een aarch64binaire en een OCI-image, die overeenkomen met een 64-bits Raspberry Pi OS-installatie. De changelog van het project vermeldde versie v0.10.15, gedateerd 30 september 2026, toen deze werd gecontroleerd op 10 oktober 2026. De voorgaande release, v0.10.14, verhielp een beveiligingslek met betrekking tot accounttoegang en adviseerde om direct te upgraden. Deze geschiedenis maakt het monitoren van updates onderdeel van de installatie, en geen optionele taak die later kan worden uitgevoerd.
Op de website van Conduit staat het project nog steeds als bètaversie vermeld en wordt aangegeven dat sommige functies ontbreken. Controleer voordat u ervoor kiest of de huidige functionaliteit aan uw behoeften voldoet, vooral als u afhankelijk bent van bridges, geavanceerd beheer of brede clientcompatibiliteit. Een Raspberry Pi kan een praktische host zijn voor een kleine implementatie, maar verkeer, mediagebruik en federatieactiviteit beïnvloeden de prestaties. Begin met een bescheiden gebruikersgroep en houd het geheugen-, temperatuur- en opslaggebruik in de gaten in plaats van te vertrouwen op een beloofd aantal gebruikers.
Wat moet je beslissen voordat je gaat installeren?
- Kies de Matrix-servernaam. In dit voorbeeld is dat
matrix.example.org. Dit domein verschijnt in de Matrix-ID's van gebruikers, zoals @alex:matrix.example.org. Kies een domein dat u beheert en wilt behouden; het later wijzigen ervan is geen eenvoudige aanpassing van de hostnaam.
- Plan openbare toegang. Geef het domein een DNS-record dat verwijst naar uw openbare IP-adres. Configureer routerforwarding en een reverse proxy met een geldig HTTPS-certificaat. De implementatiehandleiding van Conduit vereist HTTPS en stelt dat federatieverkeer bereikbaar moet zijn op poort 443 en/of 8448, afhankelijk van uw discovery- en proxyconfiguratie.
- Gebruik 64-bit Raspberry Pi OS. Controleer de architectuur met `docker run -r
uname -m...aarch64arm64
- Zorg ervoor dat de database persistent is. Sla de gegevens van Conduit op in een persistente map of Docker-volume en neem deze op in een getest back-upplan. Sla de enige kopie niet op in de beschrijfbare laag van een container of op een verwijderbare kaart die u mogelijk opnieuw formatteert.
Hoe start je Conduit met Docker?
Installeer Docker Engine en de Compose-plugin volgens de actuele instructies voor uw Raspberry Pi OS-versie. Controleer vervolgens of Docker actief is. De Conduit-documentatie bevat een lijst met de stabiele Docker Hub-image registry.gitlab.com/famedly/conduit/matrix-conduit:latesten ARM64 OCI-images. Download de stabiele image en controleer of Docker een ARM64-image heeft geselecteerd.
docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
--format '{{.Architecture}}'
Ga alleen verder als de gerapporteerde architectuur overeenkomt met uw 64-bits besturingssysteem. Maak een werkmap en een Compose-bestand aan:
mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml
Gebruik deze configuratie als uitgangspunt. Er wordt vanuit gegaan dat de reverse proxy op de Pi-host draait en Matrix-verzoeken doorstuurt naar poort 6167. Vervang de voorbeeldservernaam. De lege regel CONDUIT_CONFIGgeeft aan dat de container omgevingsvariabelen moet gebruiken, zoals de huidige Conduit Docker-instructies voor deze configuratie vereisen.
services:
conduit:
image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
container_name: conduit
restart: unless-stopped
ports:
- "127.0.0.1:6167:6167"
volumes:
- ./data:/var/lib/matrix-conduit
environment:
CONDUIT_CONFIG: ""
CONDUIT_SERVER_NAME: "matrix.example.org"
CONDUIT_ADDRESS: "0.0.0.0"
CONDUIT_PORT: "6167"
CONDUIT_DATABASE_BACKEND: "rocksdb"
CONDUIT_ALLOW_REGISTRATION: "true"
CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
CONDUIT_ALLOW_FEDERATION: "true"
CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'
Maak een privé-registratietokenbestand aan en start de service:
umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit
Het token is nodig om je eerste account te registreren; Conduit maakt de eerst aangemaakte gebruiker de serverbeheerder. Houd het .envbestand privé en upload het niet naar een openbare repository. In het voorbeeld wordt Conduit gekoppeld aan de loopback-interface van de Raspberry Pi, waardoor deze alleen bereikbaar is via een reverse proxy die op dezelfde host draait. Als je proxy in een andere container of op een andere machine draait, gebruik dan een privé Docker-netwerk of een beveiligde privé-interface in plaats van poort 6167 openbaar te maken.
Hoe zorg je ervoor dat de server bereikbaar en beveiligd is?
Configureer uw reverse proxy om het domein via HTTPS te bedienen en Matrix client- en federatieverzoeken – inclusief /_matrix/en /.well-known/matrix/– door te sturen naar Conduit. De eenvoudigste publieke configuratie hangt af van uw proxy en of federatie poort 8448 gebruikt of gedelegeerde ontdekking via poort 443. Volg het bijbehorende voorbeeld in de Docker-implementatiedocumentatie van Conduit; kopieer geen proxycode zonder de hostnamen, certificaatverwerking en netwerkpaden aan te passen.
Als u hetzelfde domein gebruikt voor server_namede Matrix ID en de URL van de homeserver, zorg er dan voor dat clients het geadverteerde HTTPS-eindpunt kunnen bereiken. Als Conduit op een apart subdomein wordt gehost van het Matrix ID-domein, configureer dan zowel de Matrix ID /.well-known/matrix/clientals de /.well-known/matrix/serverhomeserver zoals beschreven in de delegatiehandleiding. Het openen van een poort alleen is niet voldoende om discovery of TLS te configureren.
Registreer uw beheerdersaccount zo snel mogelijk bij een Matrix-client die registratietokens ondersteunt. Schakel vervolgens open registratie uit, tenzij u bewust wilt toestaan dat anderen accounts aanmaken. Wijzig in Compose de configuratie CONDUIT_ALLOW_REGISTRATIONnaar "false", verwijder het registratietoken uit de serviceomgeving en maak de container opnieuw aan met docker compose up -d. Uw bind-mounted data directory blijft behouden. Controleer wie toegang heeft tot de Docker-socket en configuratiebestanden van de Pi, aangezien zij servergeheimen kunnen onthullen of wijzigen.
Hoe kunt u controleren of de installatie werkt?
Controleer de lokale Matrix-client-API via de openbare HTTPS-hostnaam:
curl -fsS https://matrix.example.org/_matrix/client/versions
Een JSON-antwoord bevestigt dat de client-API bereikbaar is; het bewijst echter niet dat federatie werkt. Voer de officiële Matrix Federation Tester uit voor uw servernaam en corrigeer eventuele DNS-, TLS-, port-forwarding- of andere .well-knownfouten die worden gemeld. Log ten slotte in met uw nieuwe account, controleer of u beheerdersrechten hebt en test een bericht in een chatroom met een gebruiker op een andere homeserver als federatie onderdeel is van uw doelstellingen.
De bovenstaande technische details zijn gecontroleerd aan de hand van de officiële Docker-, configuratie-, delegatie- en changelog-pagina's van Conduit op 10 oktober 2026. Raadpleeg de Conduit Docker-implementatiehandleiding , de ARM64-binaire en generieke implementatiehandleiding , de configuratiereferentie , de delegatiehandleiding , de Conduit-changelog en de installatie-instructies voor Docker op Raspberry Pi OS voor details die per release kunnen verschillen.