Wil je een andere pc bedienen met jouw eigen beeldscherm, toetsenbord en muis, dan is een KVM-switch een vertrouwde oplossing. Maar wat als dat systeem op een andere locatie staat? Dan is een netwerk-KVM heel praktisch. Een nadeel: de kastjes zijn duur en de software vaak gedateerd. Maar je kunt ook zélf een netwerk-KVM bouwen. Hou je van tech-knutselen, dan is dit ID.nl-project écht iets voor jou!

Om een andere pc of een server te bedienen vanaf je bureau met maar één beeldscherm, toetsenbord en muis, is een KVM-switch een praktische oplossing (waarbij KVM staat voor keyboard, video, mouse). Gebruik je bijvoorbeeld in de regel een Windows-pc, maar wil je ook af en toe op een MacBook werken, dan schakel je gewoon om met een druk op een knop. De meeste ‘schakelkastjes’ zullen ook usb en audio doorgeven. Vooral Delock heeft een breed aanbod. De gangbare KVM-switches werken alleen lokaal. Je sluit alle ‘kabelspaghetti’ rechtstreeks aan. Dat is lastig als een server bijvoorbeeld in de meterkast staat. Daarom zijn er ook oplossingen voor KVM over het netwerk. Je kunt de pc dan gewoon op afstand via software besturen. Een nadeel is dat zulke hardware prijzig is (zie kader ‘Hardware voor KVM over IP?’).  

Daarom gaan we zoiets met eenvoudige hardware nabouwen. De basis is een Raspberry Pi met PiKVM. Je kunt eenvoudigweg via een browser inloggen om de bewuste pc of server op afstand over te nemen. Je kunt zelfs het BIOS aanpassen of een compleet besturingssysteem installeren. Dat is een groot voordeel ten opzichte van bijvoorbeeld VNC dat altijd een besturingssysteem nodig heeft. Handig als je vaker op afstand moet helpen met allerlei problemen en/of installatieperikelen (bijvoorbeeld omdat je de IT-beheerder bij je lokale vereniging bent), als je niet fysiek aanwezig kunt zijn. We richten ons vooral op het overbrengen van beeld en de besturing met toetsenbord en muis. Maar je kunt het ook uitbreiden om bijvoorbeeld een reset op afstand te kunnen doen. 

Wat gaan we bouwen? 

Een Raspberry Pi heeft enorm veel in- en uitvoermogelijkheden en vormt dan ook een logische basis voor een netwerk-KVM. Het doel is zoals gezegd vooral het overnemen van een andere pc op afstand. We zijn geïnteresseerd in het op afstand meekijken met het beeld van de bewuste pc en natuurlijk het besturen met muis en toetsenbord. De basis hiervoor is een Raspberry Pi 4 en de opensource-software PiKVM. Het werkt onafhankelijk van de pc die we besturen. PiKVM verwerkt immers zelf steeds videobeeld van de grafische kaart. Via het netwerk kun je dit op een tweede systeem bekijken waarop alleen een recente webbrowser hoeft te draaien. Je muis- en toetsenbordacties worden teruggestuurd via het netwerk. Dit stelt je in staat om bijvoorbeeld een Windows-pc te bedienen, maar je kunt ook de BIOS-instellingen wijzigen of een besturingssysteem op afstand installeren. 

Wat kost het om zelf een netwerk-KVM te bouwen? 

Je hebt voor dit project nog wat keuze in hardware. Om te beginnen is er de uitbreidingsmodule van PiKVM zelf, de V3 HAT. Dit is kwalitatief een goede optie. Maar de module is tegenwoordig wel erg prijzig. Bij Elektor (momenteel de enige leverancier in de buurt) betaal je 189,95 euro. Dat is alleen de module, dus zonder de Raspberry Pi 4 zelf. In deze masterclass bouwen we een voordelig alternatief dat ook goed werkt. Enkele verschillen ten opzichte van die uitbreidingsmodule zullen we benoemen. Naast de Raspberry Pi 4 hoef je verder alleen enkele accessoires aan te schaffen voor in totaal zo’n 25 euro. Extra opties kun je eventueel later toevoegen, bijvoorbeeld de mogelijkheid een reset op afstand uit te voeren. 

Wat heb je nodig 

Zoals gezegd vormt een Raspberry Pi 4 de basis en die geeft de beste prestaties. Helaas is de kleine singleboardcomputer nog altijd niet goed leverbaar, vanwege wereldwijde chiptekorten. Een Raspberry Pi Zero 2 W is een alternatief, maar niet veel beter leverbaar. Gelukkig zijn er naast de Pi geen lastige onderdelen nodig. Je hebt een usb-framegrabber nodig (ongeveer 15 euro) of een HDMI-naar-CSI2-adapter (ongeveer 40 euro) nodig om het beeld van de HDMI-uitgang op te vangen. We lichten de verschillen toe in paragraaf 4 en het kader ‘Adapter voor HDMI naar CSI2’. Bij de Pi Zero 2 W is zo’n adapter overigens de enige optie. Verder heb je een microSD-kaart van 16 GB of groter nodig. Plus een voeding en kabeltjes (zie gelijknamige kader). 

Lees ook: Wat is een Raspberry Pi en wat kun je ermee?

Uiteraard moet je de Pi ook op je netwerk aansluiten. Gebruik liefst een vaste netwerkverbinding en geen wifi. Een kabel is betrouwbaarder en geeft minder vertraging. Op de Pi Zero 2 W is wifi overigens de enige mogelijkheid.  Tot slot kun je nog een passende behuizing voor de Pi zoeken. 

©Daniel CHETRONI

Voeding en kabeltjes 

We zullen de Raspberry Pi van voeding moeten voorzien via de usb-c-poort. Diezelfde poort moeten we gebruiken voor de usb-kabel richting de doel-pc. Voor de Pi geldt namelijk de beperking dat alleen de poort die voeding krijgt als usb-hostapparaat kan fungeren. Deze hostfunctie is nodig voor het emuleren van muis en toetsenbord. Er zijn meerdere manieren om dat op te lossen. Op de GitHub-pagina van PiKVM zie je enkele voorbeelden. Wij gebruiken een Y-splitter kabel die usb-c splitst naar een voeding- en datakabel. De datakabel gaat dan uiteraard naar de usb-poort van de pc. Afhankelijk van het gebruikte kabeltje kun je een zogenoemde power-blocker gebruiken om de Pi te beschermen tegen spanning van de server en andersom. 

Beeld opvangen 

We gaan ervan uit dat de pc of server die je gaat overnemen een HDMI-uitgang heeft. Om het beeld over te brengen naar de Raspberry Pi gebruiken we zoals gezegd een voordelige usb-framegrabber. Je vindt ze op onder andere Amazon onder de noemer ‘usb capture card’. Het is een soort usb-dongel met HDMI-poort. Een beperking van deze budgetkeuze is dat de vertraging ongeveer twee keer zo groot is, waardoor de bediening iets minder soepel is. In de praktijk vonden wij deze optie zeer werkbaar. Zelfs op Full-HD-resolutie (1920 × 1080 pixels) met een relatief hoge framerate is de muis alleen wat stroperig. We zien dat meer als luxeprobleem, zolang het maar betrouwbaar werkt. Als het in jouw situatie niet betrouwbaar werkt, is een HDMI-naar-CSI2-adapter altijd nog een optie. Merk op dat, bij gebruik van een usb-framegrabber, nog geen H.264 wordt gebruikt. Als je via internet inlogt bij een systeem kunnen de prestaties daardoor nog wat lager zijn, afhankelijk van de beschikbare bandbreedte. 

Software voorbereiden 

Voordat we alles gaan bouwen bereiden we een microSD-kaartje voor met de software van PiKVM. Gebruik zoals aangegeven een kaartje van 16 GB of groter. Via de link https://docs.pikvm.org/flashing_os/ ga je naar de documentatie van PiKVM en daar zie je images van de verschillende versies van PiKVM. Zoek het image voor de versie die je hebt gemaakt. In deze workshop bouwen we versie 2. Je ziet dat er aparte downloads zijn de Raspberry Pi 4 en Pi Zero 2 W. Ook zijn er aparte downloads voor de versie met hdmi naar csi-adapter (Pi 4 en Zero 2 W) en de usb-dongle (alleen Pi 4). Na het downloaden van het juiste image kun je de officiële Raspberry Pi Imager gebruiken om het geheugenkaartje te maken. Installeer en open dit programma, druk op Selecteer OS, kies dan in het menu voor Gebruik eigen bestand. Blader naar het zojuist gedownloade bestand en selecteer het. Wijs ook je geheugenkaart aan onder Opslagapparaat. Daarna kun je het kaartje beschrijven. 

Alles aansluiten 

Als je alles klaar hebt liggen, is het aansluiten niet lastig. Via de splitser zorg je dat je een voeding op de usb-c-poort kunt aansluiten én een kabeltje hebt om op de usb-poort van de pc aan te sluiten. Verder verbind je een HDMI-kabel tussen de HDMI-uitgang van de pc en de HDMI-poort op de usb-framegrabber. Let er goed op dat je de usb-framegrabber in precies de juiste usb-poort op de Pi moet steken! Dat is op de Raspberry Pi 4 de zwartgekleurde usb-poort (usb 2.0) die het dichtst tegen de print aanzit. Zorg uiteraard ook dat je de netwerkkabel hebt aangesloten. In ons project gebruiken we overigens een powerbank als voeding. Dat is net wat praktischer en ook heel handig als je geen vrij stopcontact in de buurt hebt. De Raspberry Pi 4 gebruikt ongeveer 800 mA waardoor een eenvoudige powerbank ook voor langere tijd volstaat. 

©PETER PIKE

Eerste stappen 

Als je de Raspberry Pi met PiKVM hebt aangezet moet je het apparaat even de tijd geven om op te starten en enkele onderhoudstaken uit te voeren. De Pi zal automatisch een ip-adres ontvangen van je router. Je kunt het ip-adres opzoeken in de verbindingslijst van je router of met een programma als Angry IP Scanner gebruiken. Voor toegang tot PiKVM kun je een willekeurige browser gebruiken, zoals Chrome, Edge, Firefox of Safari. Heb je een probleem, wat incidenteel voorkomt, probeer dan je extensies uit te schakelen of gebruik een andere browser. Verwijs je browser naar https://pikvm of het ip-adres dat de Pi heeft gekregen. Je kunt hier inloggen met de standaard gebruikersnaam admin en ook het standaard wachtwoord is admin. Hierna kies je tussen KVM om het beeld van de bewuste pc te zien of Terminal om het terminalscherm van de Raspberry Pi te openen. 

BIOS-toegang 

Als je KVM kiest, zie je als het goed is direct het beeld van de bewuste pc. De usb-framegrabber wordt automatisch herkend en gebruikt. De bewuste pc is comfortabel te bedienen en de voordelige usb-framegrabber geeft een goed beeld. We hebben voor Full HD gekozen en dat gaat soepel over het lokale netwerk. Als test hebben we het systeem ook herstart en het BIOS geopend, wat eveneens probleemloos gaat. Het menu ATX is overigens bedoeld voor een uitbreiding waarmee je een pc op afstand kunt herstarten en aan- of uitzetten. 

Opslag koppelen 

PiKVM geeft je de mogelijkheid van virtuele schijven die een usb-stick of cd-rom kunnen emuleren. Daardoor kun je op afstand opslag koppelen aan de bewuste pc. Handig als je bijvoorbeeld een Linux-besturingssysteem wilt installeren. Als je in het menu op Drive klikt, zie je de opties voor het koppelen van opslag. Je bladert in feite naar het lokale bestand met Bestand kiezen en klikt dan op Upload. Hiermee wordt het bestand naar de Raspberry Pi geüpload. Achter Storage zie je hoeveel ruimte op de Raspberry Pi beschikbaar is. Als het uploaden voltooid is, kun je achter Image het bewuste bestand kiezen en daadwerkelijk koppelen als cd-rom of flashdrive. Wil je een iso-bestand als cd-rom koppelen, dan mag dat bestand maar 2,2 GB groot zijn. Daarom ‘past’ een iso-bestand voor de Windows-installatie niet. Je kunt dat eventueel wel op een andere manier voor elkaar krijgen. Maar je kunt natuurlijk ook gewoon een usb-flashdrive in de bewuste pc zelf prikken. 

Een NAS is voor de meeste gebruikers veel meer dan een netwerkschijf. Je kunt er eenvoudig extra toepassingen op draaien, bijvoorbeeld voor extra back-upmogelijkheden, productiviteit, multimedia en thuisautomatisering. Daarvoor is het vaak ook krachtig genoeg. Toepassingen kunnen bovendien bestanden op je NAS benutten. De makkelijkste manier om toepassingen te installeren en beheren is via Docker. We laten zien hoe je hiermee werkt op een NAS van Synology of QNAP.

Je hebt meestal geen zware server nodig voor toepassingen als Plex, Jellyfin, SABnzbd of Home Assistant. Een NAS is meestal krachtig genoeg. Soms is hooguit wat extra geheugen wenselijk. Zo heb je behalve je opslag ook al je toepassingen centraal. Mis je softwareopties op je NAS, bijvoorbeeld voor back-up of synchronisatie, dan is dat óók eenvoudig op te lossen met extra software. Maar hoe installeer je zulke toepassingen? Soms kun je een pakket installeren, bijvoorbeeld van SynoCommunity. Maar je moet dan precies de juiste variant vinden en er kunnen afhankelijkheden zijn, zoals php of Apache. Met Docker ben je veel flexibeler. Toepassingen zijn niet meer afhankelijk van de inrichting van je NAS en worden bovendien sneller bijgewerkt. Maar hoe werk je hier in de praktijk mee op een NAS? In dit artikel laten we dat zien. We beginnen met algemene uitleg over het werken met Docker op een NAS. Daarna behandelen we het downloaden van images en het maken en configureren van containers. We richten ons daarbij voornamelijk op Synology en QNAP. Heb je een NAS van een ander merk, dan zul je merken dat veel principes hetzelfde zijn. Bij het merk Ugreen lijkt de software bovendien sterk op die van Synology.

Wat heb je nodig?

Niet alle modellen van Synology en QNAP ondersteunen Docker. Synology vereist een model met x86-cpu van Intel of AMD. Bij ARM-modellen kun je het soms via een omweg installeren, maar dat is niet officieel en ook niet zonder risico's. Verder hangt het van het model af. Vooral de Plus-series (zoals de DS224+ en DS923+) en hogere modellen ondersteunen Docker. Je kunt het eenvoudig controleren door in Synology Package Center te zoeken naar Container Manager (DSM 7.2 of hoger) of (als je een oudere DSM-versie hebt) naar Docker. Bij QNAP is de toepassing, onder de naam Container Station, beschikbaar via App Center. Het is geschikt voor de meeste niet al te oude modellen. Zowel bij Synology als QNAP is 2 GB werkgeheugen aanbevolen, maar we raden minimaal 4 GB RAM aan. Voor dit artikel gebruiken we een wat oudere Synology DS918+ en QNAP TS-453Be. Beide komen nog goed mee en beschikken over recente software.

Opslag bij Docker

Belangrijke gegevens zoals configuratiebestanden, databases en cachebestanden worden in principe buiten een container bewaard. Dat kan op twee manieren. Normaal zal Docker voor de paden in de container die persistent moeten zijn een anoniem volume gebruiken. Dat krijgt een lange hash als naam. Je kunt ook zelf een naam toewijzen. We noemen dat dan een named volume. Die kun je makkelijker herkennen of hergebruiken in andere containers. De tweede optie is een zogeheten bind mount. Je koppelt dan de persistente paden in de container aan mappen op de host (het systeem waarop Docker draait), zoals je NAS. Zeker bij een NAS van Synology is dat het meest praktisch. Synology verbergt in de webinterface namelijk volumes, ook al zijn ze er wel! Bij een bind mount zie je de bestanden altijd netjes in de gedeelde mappen, zodat jij ze zelf kunt raadplegen of back-uppen.

Opslag bij een NAS

Voor het organiseren van je bestanden op een NAS gebruik je standaard al gedeelde mappen. Ga je met Docker werken, dan zul je óók zo'n map gebruiken voor de opslag voor je containers. Synology maakt die map standaard onder /docker. Bij QNAP is dat (meestal) /Container. Stel dat je WordPress wilt installeren. Het persistente pad in de container is in dit geval /var/www/html. Daar worden alle websitebestanden opgeslagen. Bij Synology zul je dan een map zoals /docker/wordpress maken die je bij de configuratie koppelt aan het container-pad /var/www/html. Er kunnen ook meerdere paden zijn. SearXNG gebruikt in de container bijvoorbeeld /etc/searxng voor de configuratie (zoals settings.yml) en /var/cache/searxng voor data en cachebestanden. Beide kun je dan koppelen met de NAS, bijvoorbeeld onder /docker/searxng/config en /docker/searxng/cache. Gebruik eventueel de bestandsbeheerder (zoals File Station) om de mappen vooraf aan te maken of aangemaakte bestanden te bekijken!

Bestanden op je NAS gebruiken

Het mooie van Docker op een NAS is dat je een container toegang kunt geven tot bestanden op die NAS, zoals foto's, video's, documenten en back-ups. Je koppelt daarvoor gewoon de gewenste gedeelde mappen of submappen. Op die manier kun je bijvoorbeeld de muziekspeler NaviDrome direct toegang tot de muziek op de NAS geven. De muziek kun je daarna netjes georganiseerd bekijken en afspelen via de vlotte webinterface. Het werkt ook samen met verschillende bekende apps. Ook bijvoorbeeld voor video's zijn goede toepassingen beschikbaar, zoals Plex en Jellyfin. Of probeer eens een toepassing als Immich of Photoprism voor je fotobibliotheek.

Met NaviDrome kun je heel handig de muziek op je NAS beluisteren.

Werken met poorten

Containers gebruiken vaak één of meerdere poorten voor bijvoorbeeld een webinterface. Een voorbeeld is de webserver nginx met http-poort 80. Bij de configuratie koppel je die interne poort 80 aan een poort op de host en daarmee je lokale netwerk. Je kunt soms hetzelfde poortnummer (in dit voorbeeld 80) kiezen, maar dat hoeft niet. In dit geval is dat ook af te raden. Liever gebruik je een hogere, vrije poort. Let goed op de bezette poorten van de NAS zelf. Dat zijn er vaak best veel. Een voorbeeld is de veelgebruikte poort 8080 die QNAP voor de webinterface gebruikt. Bij Synology zie je een overzicht van gebruikte poorten in Configuratiescherm / Infocenter op het tabje Service. Bij QNAP ga je naar Systeem / Systeemstatus / Systeemdiensten. Een blok als 6000-6999 is bij beide merken een goede optie. Heb je een container gestart, dan moet je deze vaak even de tijd geven om te starten voordat je de webinterface kunt benaderen via de ingestelde poort.

Docker Compose

Bij een NAS kun je een container relatief makkelijk via een wizard starten. Maar de details die je opgeeft, zoals poorten en volumes, kun je naderhand niet aanpassen. Wil je iets veranderen, dan zul je een nieuwe container moeten maken met de juiste instellingen. Bij zowel Synology als QNAP kun je ook werken met Docker Compose. Bij Synology heet dit een project, QNAP noemt het een toepassing. Je kunt dan de instellingen voor één of meerdere containers beheren in één yaml-bestand, meestal met de naam docker-compose.yml. Een groot voordeel is dat je dan eenvoudiger achteraf de configuratie kunt aanpassen. Het werken met meerdere containers is bovendien veel overzichtelijker. Je groepeert ze samen in één bestand, ook wel 'stack' genoemd. En je kunt alle containers in één handeling starten, stoppen of verwijderen. Bij problemen zul je overigens wel nog steeds de individuele containers moeten inspecteren (zie kader 'Problemen oplossen').

Synology: Docker installeren

Docker is meestal niet standaard geïnstalleerd. Je logt eerst in bij DSM, het besturingssysteem van je NAS. Vervolgens installeer je de toepassing via

Package Center. De toepassing heet Container Manager (sinds DSM 7.2) of (bij een eerdere versie) Docker. Bij de installatie wordt gevraagd om een brugnetwerk te configureren. Dat is het netwerk waarop containers intern communiceren. Je hoeft dit subnet (172.17.0.0/16) niet te veranderen, tenzij dit conflicteert met jouw eigen netwerk (wat heel zeldzaam is).

Synology: images downloaden

Om een container met een bepaalde toepassing te starten, heb je een image nodig. Open daarvoor Container Manager en ga naar Register. Hier kun je images op naam opzoeken. Dubbelklik dan op een image om deze te downloaden. Vaak zul je de officiële of populairste optie kiezen. De images van LinuxServer.io zijn ook altijd goed. Omdat ze dezelfde opbouw en documentatie volgen, zijn ze herkenbaar en makkelijk te gebruiken. Je kunt bij het downloaden een tag kiezen. Vaak kies je latest voor de laatste stabiele versie. Alle images die je hebt gedownload, vind je terug onder Image. Als er updates zijn, kun je die daar ook downloaden. Je containers blijven overigens draaien op de versie waarmee ze zijn gemaakt. Pas als je een nieuwe container start, wordt de nieuwe image gebruikt.

Synology: container maken

We gaan als voorbeeld een container voor SearXNG maken, een privacyvriendelijke zoekmachine die live resultaten bij andere zoekmachines ophaalt. Ga hiervoor naar Container en kies Maken. We gebruiken de image searxng/searxng. Bij het maken van de container hoef je bij Algemene instellingen niet veel te veranderen. Wel handig is de optie Automatisch opnieuw starten inschakelen, voor hogere beschikbaarheid. Op het tweede scherm, bij Geavanceerde instellingen, zie je onder het kopje Poortinstellingen dat deze toepassing in de container poort 8080 gebruikt. Bij Lokale poort kies je de lokale poort (op de host), zoals 8080 (of iets anders, als deze al in gebruik is). Na het maken van de container kun je de zoekmachine bereiken via de gekozen lokale poort, zoals http://ip-NAS:8080. Onder het kopje Volume-instellingen maak je zoals eerder toegelicht een bind mount. Koppel /docker/searxng/config met /etc/searxng en koppel /docker/searxng/cache met /var/cache/searxng. Via het venster kun je naar de map op de NAS bladeren om deze aan te wijzen (en eventueel ook aan te maken).

Synology: lokale bestanden gebruiken

Een van de voordelen is dat toepassingen bestanden op de NAS kunnen gebruiken. We noemden NaviDrome al, een populaire muziekspeler. Bij het maken van deze container koppel je poort 4533 aan de lokale poort, zoals 4533. Bij de volumes moet je opletten. NaviDrome gebruikt /data voor gegevensopslag en /music voor muziek. Koppel bij Volume-instellingen daarom bijvoorbeeld /docker/navidrome/data aan /data. Staat je muziek op de NAS onder /music/albums, dan koppel je precies die map aan /music in de container. Kies hier eventueel voor alleen leestoegang, omdat deze toepassing geen bestanden hoeft te wijzigen. Na het starten van de container zul je het programma even de tijd moeten geven om alle muziek te indexeren.

Synology: project maken

Wil je bij Synology met Docker Compose werken dan ga je naar Project en kies je Maken. Je kunt bij Bron kiezen om zelf een docker-compose.yml te uploaden, maar ook een nieuw bestand maken. Dat laatste heeft meestal de voorkeur. Je kunt de configuratie dan in het venster plakken en meteen nog wat persoonlijke aanpassingen maken. We nemen WordPress als voorbeeld dat twee containers heeft: één voor WordPress zelf en één voor een database (zoals MySQL of MariaDB). Je zet ze samen in één project en beheert ze daarna als geheel, in plaats van als twee losse containers. Bij Naam van project vullen we in wordpress (alleen kleine letters). Bij Pad kiezen we een gedeelde map op de NAS, zoals /docker/wordpress. Bij Bron kiezen we voor het maken van een docker-compose.yml. Hieronder zie je het voorbeeld voor de officiële image voor WordPress, waar we wat aanpassingen in gaan maken voor de NAS:

services:

  wordpress:

    image: wordpress

    restart: always

    ports:

      - 8080:80

    environment:

      WORDPRESS_DB_HOST: db

      WORDPRESS_DB_USER: exampleuser

      WORDPRESS_DB_PASSWORD: examplepass

      WORDPRESS_DB_NAME: exampledb

    volumes:

      - wordpress:/var/www/html

  db:

    image: mysql:8.0

    restart: always

    environment:

      MYSQL_DATABASE: exampledb

      MYSQL_USER: exampleuser

      MYSQL_PASSWORD: examplepass

      MYSQL_RANDOM_ROOT_PASSWORD: '1'

    volumes:

      - db:/var/lib/mysql

volumes:

  wordpress:

  db:

Synology: configuratie aanpassen

Hoewel de configuratie werkt, zijn enkele aanpassingen wel wenselijk. In het voorbeeld worden twee named volumes gebruikt, terwijl bind mounts handiger zijn, zeker bij Synology. Daarom halen we de onderste drie regels weg. We maken op de NAS de mappen /docker/wordpress/db en /docker/wordpress/html aan. Ten slotte passen we het volume aan voor de twee containers. Voor WordPress wordt dit als volgt:

- /volume1/docker/wordpress/html:/var/www/html

Voor de database passen we het aan naar:

- /volume1/docker/wordpress/db:/var/lib/mysql

Controleer op jouw NAS of de volumenaam volume1 klopt. Kies ook een betere gebruikersnaam en een sterker wachtwoord voor de database. Let wel op: wat je bij WORDPRESS_DB_USER en WORDPRESS_DB_PASSWORD invult, moet hetzelfde zijn als bij MYSQL_USER en MYSQL_PASSWORD. MySQL maakt met die toegangsgegevens de database, terwijl WordPress ze gebruikt om daar toegang toe te krijgen.

Nieuwe NAS? Kijk en vergelijk op Kieskeurig.nl

QNAP: Docker installeren

Om Docker te installeren op je NAS van QNAP log je eerst in bij het besturingssysteem QTS. Daarna installeer je de toepassing via App Center. Je vindt het onder de naam Container Station. De installatie wijst zichzelf. Als je de toepassing de eerste keer start, wordt gevraagd waar je gegevens van containers op wilt slaan. Je kunt de standaardmap /Container accepteren.

QNAP: image zoeken en gebruiken

Voor het zoeken van een image open je Container Station en klik je op Verkennen. Hier kun je images op naam opzoeken. Voor Docker gebruik je de resultaten van Docker Hub, de centrale verzamelplek voor Docker-images. Kies bij de gewenste image de optie Implementeer. Je kunt dan een tag kiezen (zoals latest). Vervolgens kun je direct de container configureren. Dit behandelen we in de volgende stap. Voor een overzicht van alle gedownloade images kun je naar Installatiekopieën. Wij installeren ook in dit voorbeeld een container voor SearXNG.

QNAP: container configureren

Bij de configuratie van de container kan de optie Standaardpoort voor web-URL wat verwarrend zijn. In feite maakt Container Station op basis van die poort een klikbare link die je in de webinterface ziet om de container te openen in je browser. Je kunt het dus zien als een soort shortcut. Je moet daaronder dus nog steeds de benodigde poorten openstellen. In dit voorbeeld vul je dus achter Host een poortnummer in, zoals 8000 (8080 is bij QNAP bezet!). Verander de poort bij Container (8080) niet. Vul bij Standaardpoort voor web-URL ook 8000 in, zodat de shortcut ook werkt.

Om andere opties in te kunnen stellen, zoals opslag, klik je op Uitgebreide instellingen.

QNAP: opslag configureren

SearXNG heeft in de container de persistente paden /etc/searxng en /var/cache/searxng. Bij QNAP kun je prima met (anonieme of named) volumes werken. In dit voorbeeld zullen we dat doen voor de wegwerpbare cachebestanden. Voor de configuratiebestanden maken we via File Station vooraf een map aan onder /Container/searxng/config. Achter Volume vullen we nu de naam searxngcache in, in het deel waar bij Container het pad /var/cache/searxng staat. Hier wordt dan een named volume voor gemaakt. We verwijderen de andere optie (met het pad /etc/searxng). Via het pijltje achter Voeg volume toe kiezen we Gekoppelde hostlocatie binden. Blader dan achter Host naar de zojuist gemaakte map (/Container/searxng/config). Achter Container vul je het pad /etc/searxng in. SearXNG zal zijn configuratie nu in de gekozen map bewaren en de cache in een named volume. Rond het maken van de container af. Die zal daarna worden gestart. Onder Volumes zie je alle volumes die zijn gemaakt, zoals searxngcache. Merk op dat In gebruik hier betekent dat het volume is gekoppeld aan een container, en dus niets over de status van de container zegt! Je kunt ongebruikte volumes eventueel verwijderen.

QNAP: toepassingen

QNAP ondersteunt het werken met Docker Compose. Hiervoor ga je naar Toepassing en kies je Maken. Bij Naam van de toepassing vul je een herkenbare naam in. Daaronder kun je de yaml-code invullen. Voor SearXNG, ingesteld zoals hiervoor met een bind mount voor de configuratiebestanden en een named volume voor cache, vul je het in zoals hieronder. Let op het absolute pad /share/Container/searxng/config. Dat is hoe je naar die map moet verwijzen. De code is als volgt:

services:

  searxng:

    image: searxng/searxng

    container_name: searxng

    restart: unless-stopped

    ports:

      - "8000:8080"

    volumes:

      - /share/Container/searxng/config:/etc/searxng

      - searxngcache:/var/cache/searxng

volumes:

  searxngcache:

Het maken van eventuele aanpassingen is niet heel intuïtief. Je gaat hiervoor naar Toepassingen en klikt achter de toepassing op het instellingenicoontje. Kies dan de optie Opnieuw maken. Je kunt nu de yaml-code bewerken. Na het maken van de aanpassingen zal een nieuwe container worden opgebouwd met deze nieuwe configuratie.

Beheer containers op je NAS met Portainer

Het kan om meerdere redenen praktisch zijn om Portainer te installeren op je NAS, een grafische webinterface voor het beheer van je containers. Het is wat overzichtelijker en er blijft, zeker in vergelijking met Container Manager van Synology, minder verborgen. Je kunt Portainer gewoon via Docker installeren. Het is handig eerst een map te maken voor Portainer, waar het zijn configuratie persistent kan bewaren. Maak dan een project in Container Manager met de onderstaande configuratie:

services:

  portainer:

    image: portainer/portainer-ce:latest

    container_name: portainer

    restart: always

    ports:

      - "9443:9443"   # HTTPS toegang

      - "9000:9000"   # (optioneel, oudere HTTP-poort)

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock

      - /volume1/docker/portainer:/data

Bij QNAP kun je dezelfde configuratie gebruiken, maar vervang dan /volume1/docker/portainer:/data door /share/Container/portainer:/data. Na het starten zie je op https://ip-NAS:9443 (of http://ip-NAS:9000) de webinterface van Portainer. De eerste keer wordt gevraagd om een wachtwoord aan te maken. Portainer heeft (ook) een kleine leercurve, maar het geeft je veel opties, en werkt op elk systeem hetzelfde.

Je kunt nu in Portainer alles rondom Docker beheren, zoals containers en images.

Wat maakt een koelkast de allerbeste van het jaar? Niet een glanzende folder vol beloftes, maar de dagelijkse ervaringen van echte gebruikers. De Liebherr IRd 3900 is door consumenten van Kieskeurig.nl bekroond met de prestigieuze Best Reviewed van het Jaar-award 2025. Van de slimme EasyFresh-technologie tot het fluisterstille ontwerp en de praktische indeling: lees waarom dit model als de absolute favoriet uit de bus kwam en waarom gebruikers er zo enthousiast over zijn.

Partnerbijdrage - in samenwerking met Liebherr

Wie een inbouwkoelkast zoekt, heeft enorm veel keuze, maar één model wist het afgelopen jaar de harten van de Nederlandse consument echt te veroveren. Met zijn doordachte design, gebruiksvriendelijke bediening en bewezen betrouwbaarheid is de Liebherr IRd 3900 uitgeroepen tot Best Reviewed van het Jaar 2025. In dit artikel lees je wat deze inbouwkoelkast zo bijzonder maakt – en waarom gebruikers er zo lovend over zijn.

De stem van de consument: Best Reviewed 2025

De beste keuze volgens consumenten – dat is waar het bij Best Reviewed 2025 om draait. Want niets zegt zo veel als de ervaring van andere gebruikers. Jaarlijks delen duizenden consumenten hun eerlijke mening op Kieskeurig.nl. Hun reviews vormen de basis voor de Best Reviewed-awards. De producten die deze titel verdienen, hebben zich een heel jaar lang bewezen in de praktijk: ze blinken uit in kwaliteit, gebruiksgemak en klanttevredenheid. Absolute consumentenfavorieten dus – en in de categorie inbouwkoelkasten is de Liebherr IRd 3900 de winnaar geworden.

Van EasyFresh tot verstelbare indeling

De Liebherr IRd 3900 is een inbouwkoelkast die laat zien waarom het Duitse merk al jaren bekendstaat om betrouwbaarheid en technische vernieuwing. Deze koelkast combineert een strak, tijdloos design met praktische functies die het dagelijks leven makkelijker maken. Dankzij het EasyFresh-systeem blijven groenten en fruit langer vers: de ideale luchtvochtigheid in de lade voorkomt uitdroging en zorgt dat smaak en textuur behouden blijven. Dat maakt het apparaat niet alleen zuinig in gebruik, maar helpt ook voedsel langer goed te houden en verspilling te beperken.

©Liebherr

Wie de deur opent, merkt direct de doordachte indeling. Het interieur en de deurvakken zijn over de volledige hoogte verstelbaar, zodat je er moeiteloos alles in kwijt kunt wat koel moet blijven: of dat nu hoge flessen zijn of een brede ovenschotel. Fijn daarbij is dat de glazen draagplateaus tot wel 30 kg kunnen dragen. Daarbij zorgt de heldere LED-plafondverlichting voor een perfect overzicht, zelfs wanneer de koelkast vol is. De bediening verloopt via een intuïtief Touch-display, waarmee je supersnel de temperatuur of functies kunt aanpassen. Bovendien is de IRd 3900 voorbereid op SmartHome-toepassingen (accessoire). Liebherr biedt, na registratie, maar liefst 10 jaar garantie op dit model – dat doe je als merk natuurlijk alleen maar wanneer je helemaal overtuigd bent van je product.

©Liebherr

Waarom gebruikers enthousiast zijn

Die combinatie van slimme technologie en gebruiksgemak is ook precies wat consumenten zo waarderen. Uit tientallen reviews op Kieskeurig.nl blijkt dat gebruikers de IRd 3900 een uitzonderlijk hoge gemiddelde score van 9,1 geven. De koelkast wordt geroemd om zijn stille werking – "Dan zet je hem aan en hoor je nagenoeg niets! Heerlijk stille koelkast!" – en om de praktische indeling die volgens velen "fijn en flexibel" is. Ook wat betreft dagelijks gemak scoort de IRd 3900 hoog. "Door het digitale display makkelijk in te stellen naar de gewenste koeltemperatuur", zegt een van de reviewers. Een ander voegt daar nog aan toe: "Mooie heldere verlichting … Makkelijke display, goed zichtbaar en makkelijk te bedienen." Daarnaast valt op dat veel reviewers de energiezuinigheid en afwerking noemen als pluspunten: het apparaat voelt degelijk aan en doet precies wat het belooft.

©Liebherr

Een optelsom van kwaliteiten

De reden dat de Liebherr IRd 3900 de titel Best Reviewed van het Jaar 2025 heeft gewonnen, ligt dus in de optelsom van al deze kwaliteiten. Hij combineert gedegen techniek met praktische voordelen die in het dagelijks leven écht verschil maken. Of het nu gaat om de versheid van producten, het handige display of het overzichtelijke interieur: deze inbouwkoelkast weet consumenten te overtuigen in alles wat ertoe doet. En dat maakt de Liebherr IRd 3900 niet alleen een technisch sterk product, maar vooral een betrouwbare huisgenoot waar mensen jarenlang plezier van hebben.

Een eerlijk oordeel

Natuurlijk is geen enkel product perfect. Gebruikers op Kieskeurig.nl zijn ook kritisch: sommige kopers vinden de groente- en fruitlade aan de kleine kant of noemen dat er sneller condens kan ontstaan. Een paar mensen geven ook aan dat je even moet wennen aan het instellen via het display, en dat de montage van de deur wat meer aandacht vraagt. Tegelijk zie je waarom dat voor de meeste kopers geen struikelblok is. Ze benadrukken vooral hoe stil de koelkast is, hoe ruim hij aanvoelt en hoe makkelijk je de indeling aanpast aan wat je in huis haalt. Daardoor wegen die minpunten voor veel mensen niet op tegen wat je dagelijks merkt: rust in de keuken, goed overzicht en een indeling die je naar eigen wens kunt aanpassen.