ID.nl logo
Overstappen op Linux - Deel 2: Linux Mint installeren
© Reshift Digital
Huis

Overstappen op Linux - Deel 2: Linux Mint installeren

In het eerste deel van onze reeks maakte je kennis met Linux als alternatief voor Windows 10. In dit tweede deel duiken we in de praktijk. We geven je uitleg bij de keuzes tijdens de installatie van Linux Mint 17.3. Daarna maken we je wegwijs in de ondersteuning van je hardware.

Heb je deel 1 niet gelezen? Lees het artikel hier terug.

Tip 01: Iso controleren

Op het einde van deel 1 van deze reeks heb je normaal het iso-bestand van de Cinnamon-editie van Linux Mint 17.3 gedownload. Deed je dat nog niet, doe dat dan nu. Voordat we hiermee aan de slag gaan, controleer je het best het iso-bestand. Want hoe weet je zeker dat het bestand tijdens het downloaden niet corrupt is geraakt of dat de mirror waarvan je het bestand hebt gedownload niet stiekem een versie met backdoor online heeft gezet? Lees ook: 15 manieren om met Linux aan de slag te gaan.

Om dat na te gaan, toont de downloadpagina van het iso-bestand een MD5-checksum, in dit geval e71a2aad8b58605e906dbea444dc4983. Download voor de controle het programma WinMD5Free en pak het bestand WinMD5.exe uit. Start het programma en sleep het iso-bestand dat je wilt controleren vanuit de verkenner naar het tekstveld naast het knopje Browse. Als de voortgangsbalk helemaal groen is, toont het programma de berekende MD5-checksum. Kopieer de MD5-checksum die op de downloadpagina van het iso-bestand wordt vermeld en plak die in het tekstveld naast het knopje Verify. Klik op de knop om te controleren of beide waardes overeenkomen. Als er een verschil is, download dan het iso-bestand opnieuw van een andere mirror en controleer de MD5-checksum opnieuw.

©PXimport

Tip 01 Controleer altijd eerst met WinMD5Free of het gedownloade iso-bestand niet corrupt is.

Bevat mijn iso-bestand een backdoor?

In tip 1 vertrouwen we het iso-bestand als de MD5-checksum overeenkomt met die op de downloadpagina. Maar wat als een cybercrimineel op de website van Linux Mint inbreekt, er een iso-bestand met backdoor plaatst en de MD5-checksum op de downloadpagina vervangt door die van zijn aangepaste iso-bestand? Dan lijkt alles volgens de controle met WinMD5Free in orde, terwijl je wel een iso-bestand met backdoor in handen hebt.

Dit scenario is niet eens zo vergezocht: op 20 februari 2016 voerde een cybercrimineel exact deze aanval uit, waardoor enkele honderden gebruikers een versie van Linux Mint installeerden die hun computer liet deel uitmaken van een botnet. Er bestaat gelukkig een betrouwbare manier om na te gaan of een iso-bestand afkomstig is van het Linux Mint-project, maar helaas maakt het project dit niet gemakkelijk. De enige documentatie daarvoor vind je momenteel in een artikel op het forum van Linux Mint dat na de serverkraak verscheen.

©PXimport

Op 20 februari 2016 plaatste een cybercrimineel een backdoor in de iso-bestanden van Linux Mint.

Tip 02: Iso naar usb-stick

Als je het iso-bestand hebt gecontroleerd, kun je het naar een usb-stick schrijven zodat je Linux Mint op je computer kunt installeren. Neem een lege (!) usb-stick met een opslagcapaciteit van 2 GB of meer en steek die in je computer. Rechtsklik in Verkenner op het icoontje van de stick en klik op Formatteren.

Controleer of het bestandssysteem op FAT32 staat en klik op Starten om de stick te formatteren. Download daarna het programma Win32 Disk Imager en start het installatieprogramma. Na installatie vind je het programma onder de naam Win32DiskImager in het startmenu. Open het programma en klik op het mapicoontje naast het tekstveld Image File. Kies in het volgende venster rechts van het tekstveld voor de bestandsnaam *.* in plaats van Disk Images (*.img *.IMG), zodat je je iso-bestand kunt selecteren. Klik op Openen en kies daarna onder Device voor de schijfletter van je usb-stick. Ga na of dit de juiste schijfletter is, want Win32 Disk Imager overschrijft deze schijf volledig! Klik dan op Write om het schrijven te starten. Overigens kan Win32 Disk Imager ook de MD5-checksum van het iso-bestand controleren, maar om ongelukken te vermijden als je per ongeluk te snel op Write klikt, schakelden we daarvoor een afzonderlijk programma in.

©PXimport

Tip 02 Met Win32 Disk Imager schrijf je het iso-bestand naar een usb-stick.

Tip 03: Opstarten van usb

Nu je de opstartbare usb-stick van Linux Mint hebt, steek je die in de computer waarop je de distributie wilt installeren. Start de computer op. Als je geen opstartmenu van Linux Mint te zien krijgt, herstart je computer dan en zorg dat de usb-stick als eerste in de opstartvolgorde staat. Dat kan in de instellingen van je BIOS, waarvoor je tijdens het opstarten op een toets zoals F2 of Esc moet drukken.

Op andere computers activeert een toets zoals F12 een opstartmenu waarin je kiest van welke schijf je wilt opstarten. Als je een opstartmenu van Linux Mint te zien krijgt dat 10 seconden aftelt, zit je goed. Na een tijdje krijg je een live-versie van Linux Mint 17.3 te zien, met op het bureaublad een icoontje Install Linux Mint. Klik daarop en kies vervolgens Nederlands als taal. Als je daarna de vraag krijgt om verbinding te maken met een draadloos netwerk, kies dan je netwerk en voer je wachtwoord in. Vink Wachtwoord tonen aan om er zeker van te zijn dat Linux Mint de juiste toetsenbordindeling gebruikt. Toont het installatieprogramma geen draadloze netwerken, dan heeft het geen drivers voor je wifi-chip. Dat lossen we na de installatie op. Steek voorlopig een ethernetkabel in je pc.

©PXimport

Tip 03 Geef je wifi-wachtwoord op voor een internetverbinding tijdens de installatie.

Tip 04: Partities kiezen

In de volgende stap van de installatie controleert het programma of je computer over voldoende schijfruimte beschikt, op een stroomvoorziening is aangesloten en verbonden is met internet. We gaan echter met de installatie door op Verder te klikken. Nu krijg je de vraag op welke manier je Linux Mint wilt installeren. Als je al Windows op de schijf hebt staan, krijg je de keuze tussen Linux Mint naast Windows installeren (dualboot) of de schijf wissen en er Linux Mint op installeren.

Opgelet: die tweede optie verwijdert niet alleen Windows, maar ook alle bestanden op de schijf! Een derde optie is Iets anders: dan maak je zelf partities aan. Doe dit alleen als je goed weet waar je mee bezig bent. Als je ervoor kiest om de schijf te wissen, kun je nog twee opties aanvinken: encryptie van de installatie is zeker aan te raden. Vink je die optie aan, dan wordt ook de tweede optie, LVM (Logisch volumebeheer), automatisch aangevinkt. Heb je een keuze gemaakt voor het installatietype, klik dan op Installeer nu en voer een beveiligingssleutel in. Bevestig daarna dat je je schijf wilt formatteren.

©PXimport

Tip 04 We raden aan om je installatie van Linux Mint te versleutelen.

Tip 05: Instellingen

Terwijl het installatieprogramma zijn werk op de achtergrond doet, krijg je nu de mogelijkheid om wat instellingen voor Linux Mint op te geven. Eerst voer je je locatie in, die normaal al juist staat op basis van je IP-adres. Daarna kies je je toetsenbordindeling. Weet je niet zeker of je hier de juiste keuze maakt, typ dan in een tekstveld iets in om het te controleren.

In de volgende stap maak je een gebruiker aan. Voer je naam in, de naam van je computer (die wordt onder andere in je netwerk getoond), een gebruikersnaam en wachtwoord. Bij het wachtwoord toont het installatieprogramma of het sterk genoeg is, net zoals dat bij het wachtwoord voor het versleutelen van je volledige schijf gebeurde. Je kunt hier ook kiezen om automatisch aan te melden, maar wij raden aan om te kiezen voor Mijn wachtwoord vragen om aan te melden. De optie Versleutel mijn persoonlijke map versleutelt je persoonlijke map. Als je tijdens het kiezen van de partities koos om je hele Linux-systeem te versleutelen, is dat in principe niet meer nodig. Daarna krijg je een diavoorstelling over de mogelijkheden van Linux Mint. Als de installatie nog niet voltooid is, kun je intussen alvast wat programma's uitproberen via het menu linksonder.

Tip 06: Stuurprogramma's

Wanneer de installatie voltooid is, klik je op Nu herstarten. Wacht op de melding om het installatiemedium te verwijderen en haal dan de usb-stick uit je computer. Druk op Enter om je computer te herstarten. Als je tijdens de installatie voor versleuteling van je schijf hebt gekozen, krijg je de vraag om het wachtwoord in te voeren. Daarna krijg je het aanmeldvenster te zien. Vul je gebruikersnaam en wachtwoord in.

Als je eenmaal bent aangemeld, krijg je een welkomstscherm te zien met links naar meer informatie. Klik op Stuurprogramma's en voer het wachtwoord van je gebruiker in. Linux Mint zoekt nu naar hardware waarvan momenteel geen stuurprogramma geïnstalleerd is. Je krijgt dan de keuze uit meerdere drivers.

Vink degene aan waarbij aanbevolen staat, onthoud de naam en klik op Wijzigingen doorvoeren. Klik daarna op Herstarten om de driver in te schakelen. Als het om de driver voor je wifi-adapter ging, dan zou je bij het opnieuw inloggen de melding moeten krijgen dat er wifi-netwerken zijn. Als dit niet zo is, open dan opnieuw het programma Stuurprogrammabeheer (in het menu linksonder) en kies een andere optie. Krijg je geen opties meer, zoek dan eerst in het programma Softwarebeheer naar de geïnstalleerde driver (daarom moest je de naam onthouden), dubbelklik erop en klik op Verwijderen. Herstart daarna voor een nieuwe poging. Zie ook het kader 'Driver van fabrikant'.

©PXimport

Tip 06 Krijg je hardware aan de praat met de juiste driver.

Driver van fabrikant

Linux Mint heeft standaard al talloze drivers ingebouwd. En als ze niet standaard zijn geactiveerd, zijn ze via het Stuurprogrammabeheer in te schakelen. Maar soms is dat niet voldoende. Ga dan op de website van de fabrikant van je hardware op zoek naar drivers voor Linux. Die komen meestal in twee vormen: rpm- of deb-bestanden. Voor Linux Mint heb je het deb-bestand nodig. Kies voor de juiste bit-versie: 32 of 64. Het programma Systeeminformatie toont je bij Besturingssysteem of je een 32bit- of 64bit-systeem hebt. Volg de instructies van de fabrikant om de drivers te installeren. Gaat het om een tar.gz-bestand, open het dan eerst met het programma Archiefbeheer en pak de inhoud uit.

©PXimport

Soms moet je op de website van de fabrikant op zoek gaan naar drivers.

Tip 07: Netwerkprinter

Krijg je je hardware nog steeds niet aan de praat, bekijk dan eens de websites die we in tip 6 van het vorige artikel van deze reeks aanraadden. Sommige apparaten moet je overigens eerst via usb aansluiten voor je een stuurprogramma kunt installeren. En een netwerkprinter bijvoorbeeld moet uiteraard eerst ingeschakeld en via het netwerk bereikbaar zijn.

We tonen je hier hoe je een netwerkprinter toevoegt. Open in het menu linksonder het programma Afdrukbeheer en klik op Toevoegen. Klik op het driehoekje naast Netwerkprinter, waarna Linux Mint op je netwerk begint te zoeken naar printers. Selecteer je printer en klik op Volgende. Linux Mint zoekt daarna naar stuurprogramma's en vraagt je eventueel om opties in te stellen. Geef je printer een naam, omschrijving en locatie en klik op Toepassen. Klik op Testpagina afdrukken om uit te proberen of je printer correct is toegevoegd. Je kunt ook nog allerlei opties instellen, zoals de standaard-afdrukkwaliteit. Daarna is je printer in alle programma's beschikbaar.

©PXimport

Tip 07 Een printer toevoegen is zo gebeurd.

Vervolg

Je hebt nu Linux Mint geïnstalleerd en je hardware aan de praat gekregen. In het volgende deel van deze reeks maken we je wegwijs in Linux Mint en tonen we je de verschillen met Windows. We laten je zien wat je allemaal kunt instellen en we besteden ook aandacht aan de beveiliging. In het artikel erna krijg je te zien hoe je software installeert, updatet en verwijdert. We bespreken er ook alternatieven voor bekende Windows-software en brengen Windows-programma's in VirtualBox of Wine aan de praat. In het laatste deel van deze reeks zullen we tot slot Linux integreren met je thuisnetwerk om bestanden te delen en media te streamen.

Klaar voor de volgende stap? In het derde deel gaan we echt aan de slag met Linux.

▼ Volgende artikel
Bouw je eigen dashboard met Homepage: al je webapplicaties overzichtelijk op één plek
Huis

Bouw je eigen dashboard met Homepage: al je webapplicaties overzichtelijk op één plek

Heb je meer dan een handvol webapplicaties op een Linux-server draaien? Dan is een dashboard met links naar deze applicaties een uitkomst. Het project Homepage biedt precies dat, inclusief widgets die allerlei statistieken van je services weergeven. In dit artikel installeren we Homepage en laten we je zien hoe je het integreert met je bestaande services.

Dit gaan we doen

In deze masterclass richten we een persoonlijk dashboard in met Homepage. Je leert hoe je de tool installeert in Docker, services groepeert en uitbreidt met widgets voor statistieken zoals cpu- en geheugengebruik, uptime of weersinformatie. We laten zien hoe je containers automatisch herkent, monitoring toevoegt en ook bladwijzers of alternatieve dashboards gebruikt. Zo krijg je één centrale plek waar je al je webapplicaties en services snel terugvindt en beheert.

Lees ook: Windows gebruiken naast of binnen Linux? Zo krijg je het soepel aan de praat met Docker


⬇️ Code downloaden

In dit artikel staat voorbeelden met YAML-code. Omdat YAML erg gevoelig is voor foute spaties en inspringingen, kun je die code beter downloaden en daarna bekijken of kopiëren. Zie het bestand homecode.txt, beschikbaar via deze link.


Homepage helpt je om diverse webapplicaties in één dashboard te organiseren. Dit is handig als je services in Docker-containers draait of eenvoudig toegang wilt tot de beheerpagina’s van apparaten zoals je modem, router en NAS.

Hoewel dit klinkt als een veredelde bookmark-manager, doet Homepage meer dan alleen links op een pagina verzamelen. Het project ondersteunt widgets voor meer dan honderd services en kan zo bijvoorbeeld het cpu- en geheugenverbruik van je hypervisor of het aantal ongelezen artikels in je RSS-lezer tonen. Je hoeft daardoor vaak zelfs niet op de links te klikken om even snel de status van je services te bekijken.

Docker Compose

We gaan ervan uit dat je een Linux-server hebt waarop je services met behulp van Docker Compose in Docker-containers draait. Homepage draai je dan gewoon in een Docker-container naast je bestaande services, al zijn er ook andere installatie-opties. In ons voorbeeld draaien we Docker op Debian 12. Maak om te beginnen een map waarin de container van Homepage zijn data en configuratie kan opslaan, met deze opdracht:

$ mkdir -p containers/homepage

Zet vervolgens in je bestand docker-compose.yml (het bestand waarin je al je containers definieert) een service voor Homepage:

services:

  homepage:

    image: ghcr.io/gethomepage/homepage:latest

    container_name: homepage

    ports:

      - 3000:3000

    volumes:

      - /home/koan/containers/homepage:/app/config

    environment:

      HOMEPAGE_ALLOWED_HOSTS: debian.home:3000

    restart: unless-stopped

Homepage kun je op diverse manieren installeren.

Homepage opstarten

Wijzig in het gedefinieerde volume de directory vóór de dubbele punt naar het volledige pad van de directory die je voor de container hebt aangemaakt. Stel de waarde van de omgevingsvariabele HOMEPAGE_ALLOWED_HOSTS gelijk aan het domein of het ip-adres van de host, gescheiden door een dubbele punt van het poortnummer. Als je met een reverse proxy werkt, zet je hier het domein waarop de applicatie via die proxy bereikbaar is.

Start de container met:

$ docker-compose up -d

Zodra het image gedownload is en de container draait, open je Homepage in je browser op de url die je in HOMEPAGE_ALLOWED_HOSTS hebt gedefinieerd. Je ziet dan een voorbeeldpagina met van boven naar onder een header, groepen met services en groepen met bladwijzers.

Het standaarddashboard van Homepage vlak na de installatie.

Informatiewidgets

In de header vind je enkele informatiewidgets. Hoewel deze niet de kern van de functionaliteit van Homepage uitmaken, bieden ze nuttige aanvullende informatie. Standaard zie je het cpu-verbruik, het beschikbare geheugen en de vrije schijfruimte van de host. Er is ook een tekstveld om te zoeken via DuckDuckGo. De definitie van deze twee widgets vind je in het bestand widgets.yaml in de directory van de Homepage-container.

In de online documentatie van de informatiewidgets lees je hoe je hun gedrag aanpast. Zo kunnen we de widget Resources ook de uptime van het systeem laten tonen (uptime: true) en met de optie expanded: true meer informatie over de cpu, het geheugen en de schijfruimte laten weergeven. De widget ziet er dan als volgt uit in widgets.yaml:

- resources:

    label: System

    expanded: true

    cpu: true

    memory: true

    uptime: true

    disk: /

Weersomstandigheden

Homepage biedt twee widgets om het weer in de header te tonen: één via Open-Meteo en één via OpenWeatherMap. De eerste vereist geen registratie, dus daarvoor hoef je alleen maar de gps-coördinaten van je locatie in te voeren. In widgets.yaml ziet dat er als volgt uit:

- openmeteo:

    label: Attenrode

    latitude: 50.8773405

    longitude: 4.9213237

    timezone: Europe/Brussels

    units: metric

    cache: 5

    format:

      maximumFractionDigits: 1

Met cache: 5 laten we de widget de weergegevens vijf minuten lang cachen om de servers van Open-Meteo te ontlasten. Verder biedt Homepage nog andere informatiewidgets aan, bijvoorbeeld voor beurskoersen of de datum en tijd.

In de header van Homepage plaats je allerlei informatiewidgets.

Services toevoegen

De kernfunctionaliteit van Homepage ligt uiteraard in het groeperen van services in één dashboard. De standaardconfiguratie voegt drie groepen toe met elk één service. De YAML-code hiervoor vind je in het bestand services.yaml. Vervang die door je eigen groepen. Je kunt bijvoorbeeld een groep Network aanmaken met links naar de beheerinterfaces van je modem/router en accesspoints:

- Network:

  - Proximus:

      href: http://192.168.1.1

      description: Modem

      icon: mdi-web

  - OpenWrt:

      href: http://gl-mt3000.home

      description: Accesspoint

      icon: openwrt

De eigenschap icon kan een absolute url zijn of een naam uit de lijst op de website Dashboard Icons. Begin de naam van een pictogram met mdi- voor een keuze uit Material Design Icons , met si- voor een keuze uit Simple, of met sh- voor een keuze uit Self-Hosted Dashboard Icons.

Ook groepen kunnen een pictogram krijgen. Dat definieer je dan in het bestand settings.yaml:

layout:

  Network:

    icon: mdi-lan-connect

  Infrastructure:

    icon: mdi-server-network

  Services:

    icon: mdi-apps

Services en groepen kun je pictogrammen geven, bijvoorbeeld van de website Self-Hosted Dashboard Icons.

Servicewidgets

Tot nu toe lijkt ons dashboard wat op een veredeld lijstje met bladwijzers. Maar Homepage ondersteunt ook servicewidgets voor meer dan honderd services. Controleer in de lijst of je services ondersteund zijn. Draai je bijvoorbeeld OPNsense op je router, dan krijg je met de volgende widget de processorbelasting, het gebruikte geheugen, en de upload- en downloadhoeveelheden van je WAN-interface te zien:

- OPNsense:

      href: https://opnsense.home

      description: Router

      icon: opnsense

      widget:

        type: opnsense

        url: https://opnsense.home

        username: KEY

        password: SECRET

Voor username en password vul je de API-sleutel en het ‘secret’ in die je in de webinterface van OPNsense aanmaakt via System / Access / Users. De documentatie van Homepage voor de OPNsense-widget legt dit gedetailleerd uit. Wil je slechts een deel van de statistieken zien, dan kan dat door de widget uit te breiden met een regel als:

fields: ["wanDownload", "wanUpload"]

Homepage ondersteunt widgets voor meer dan honderd services.

Meerdere widgets

Je kunt een service ook van meerdere widgets voorzien. Dat is bijvoorbeeld handig bij monitoringtools zoals Uptime Kuma. Voeg aan de OPNsense-service dan de OPNsense-widget toe voor servicespecifieke statistieken en de widget van Uptime Kuma voor beschikbaarheidsstatistieken. In plaats van één object widget bevat de service dan een object widgets met een lijst die beide widgets bevat:

  - OPNsense:

      href: https://opnsense.home

      description: Router

      icon: opnsense

      widgets:

        - type: opnsense

          url: https://opnsense.home

          username: KEY

          password: SECRET

        - type: uptimekuma

          url: https://uptime-kuma.rubus.home

          slug: router

          fields: ["uptime", "incident"]

De widget van Uptime Kuma gebruikt data van een statuspagina. Die moet je dus eerst in Uptime Kuma aanmaken, en de naam van de statuspagina vul je bij slug in de widget in. Als de statuspagina bijvoorbeeld toegankelijk is via https://uptime-kuma.rubus.home/status/router, dan is de slug router.

Homepage kan een statuspagina van Uptime Kuma in een service integreren.

Beschikbaarheid monitoren

Ook zonder speciale monitoringtools kun je met Homepage eenvoudig te zien krijgen of al je services momenteel online zijn. Dat kan met de eigenschap ping of siteMonitor in de service. Voeg bijvoorbeeld aan de service voor OPNsense ping: opnsense.home toe. Homepage stuurt dan regelmatig een ICMP-echopakket (ping) naar de host en toont de beschikbaarheid in de rechterbovenhoek van het kader van de service.

Met siteMonitor: https://opnsense.home daarentegen voert Homepage een HTTP HEAD-verzoek uit naar de url om te controleren of de webpagina beschikbaar is. Zo weet je niet alleen dat de host online is, maar ook dat de webserver tenminste draait en de pagina aanbiedt. Let op dat je hier de volledige url met https:// of http:// dient te gebruiken. De stijl van de getoonde status kun je overigens in settings.yaml aanpassen met bijvoorbeeld statusStyle: dot of statusStyle: basic.

Enkele services met pictogrammen, widgets en statusinformatie.

Docker-containers integreren

Als je services in Docker-containers draait, kan Homepage via de API van de Docker-engine statistieken over die containers opvragen en zelfs automatisch services herkennen. Configureer hiervoor een Docker-instance voor Homepage in docker.yaml. Als je Homepage met de Docker-socket laat verbinden, kan dat met de volgende configuratie:

local-docker:

  socket: /var/run/docker.sock

In je Docker Compose-bestand moet je deze socket als volume in de Homepage-container aankoppelen:

    volumes:

      - /home/koan/containers/homepage:/app/config

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

Docker Socket Proxy

Een veiliger alternatief om Homepage toegang tot Docker te geven, is via Docker Socket Proxy. Je laat die laatste dan rechtstreeks met de Docker-socket verbinden en de andere containers via een HTTP API beperkte bevoegdheden geven. Voeg daarvoor in je Docker Compose-bestand de volgende service voor Docker Socket Proxy toe:

  docker-socket-proxy:

    image: ghcr.io/tecnativa/docker-socket-proxy:0.3.0

    container_name: docker-socket-proxy

    volumes:

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

    environment:

      CONTAINERS: 1

    restart: unless-stopped

Standaard geeft Docker Socket Proxy sterk ingeperkte API-toegang tot de Docker-engine, en sowieso alleen-lezen. Met de omgevingsvariabele CONTAINERS: 1 geven we toegang tot informatie over containers, precies wat Homepage nodig heeft.

Wijzig nu in het bestand docker.yaml de definitie van local-docker naar:

local-docker:

  host: docker-socket-proxy

  port: 2375

Omdat de container van Docker Socket Proxy zich in hetzelfde netwerk als Homepage bevindt, is die onder de naam docker-socket-proxy bereikbaar, wat we hier als host invullen.

Maak dan de containers opnieuw aan met de opdrachten:

docker-compose down

docker-compose up -d

Containers monitoren

Containers die in hetzelfde Docker Compose-bestand als Homepage zijn gedefinieerd, kun je nu door die laatste laten monitoren. Je moet dan bij de service in services.yaml de Docker-server en de naam van de container opgeven, bijvoorbeeld:

- Services:

  - FreshRSS:

      href: http://debian.home:8081

      description: Feed aggregator

      icon: freshrss

      server: local-docker

      container: freshrss

De waarde van server is hier de naam van de Docker-instance in docker.yaml, namelijk local-docker. De waarde van container is hier de naam van de container, gedefinieerd in container_name in het Docker Compose-bestand.

Na het herladen van de webpagina van Homepage krijgt de FreshRSS-service de status RUNNING in de rechterbovenhoek of EXITED wanneer de container gestopt is. Klik op de status voor gedetailleerdere statistieken zoals de processorbelasting, het geheugengebruik en netwerkverkeer.

Services automatisch detecteren

Elke keer dat je nu een service toevoegt, moet je de container aan je Docker Compose-bestand toevoegen en een definitie van de service aan het bestand services.yaml van Homepage. Maar Homepage ondersteunt ook het automatisch detecteren van services voor containers met behulp van labels. Met deze aanpak hoef je services.yaml niet meer bij te werken en hoef je slechts één bestand te veranderen. Voor FreshRSS kan dat bijvoorbeeld als volgt:

  freshrss:

    image: docker.io/freshrss/freshrss:1.26.1-alpine

    container_name: freshrss

    ports:

      - 8081:80

    volumes:

      - /home/koan/containers/freshrss/data:/var/www/FreshRSS/data

      - /home/koan/containers/freshrss/extensions:/var/www/FreshRSS/extensions

    environment:

      CRON_MIN: "1,31"

      TZ: Europe/Brussels

    restart: unless-stopped

    labels:

      - homepage.group=Services

      - homepage.name=FreshRSS

      - homepage.href=http://debian.home:8081

      - homepage.description=Feed aggregator

      - homepage.icon=freshrss

In de labels van deze container geef je dus aan dat je in de groep Services een service met de naam FreshRSS toevoegen, met de gegeven link, beschrijving en pictogram. De opties server en container uit de vorige paragraaf zijn met deze aanpak overbodig, omdat Homepage deze automatisch via de API van de geconfigureerde Docker-instance verkrijgt. Na opnieuw het uitvoeren de volgende twee commando’s ontdekt Homepage automatisch de service en voegt deze aan de juiste groep toe:

docker-compose down

docker-compose up -d

Widgets

Op dezelfde manier kun je widgets toevoegen via labels. In het voorbeeld uit de vorige stap voeg je dan de volgende labels toe:

      - homepage.widget.type=freshrss

      - homepage.widget.url=http://freshrss

      - homepage.widget.username=USER

      - homepage.widget.password=PASSWORD

Wil je meerdere widgets aan een container toevoegen, geef dan elk widget een index:

      - homepage.widgets[0].type=freshrss

      - homepage.widgets[0].url=http://freshrss

      - homepage.widgets[0].username=USER

      - homepage.widgets[0].password=PASSWORD

      - homepage.widgets[1].type=uptimekuma

      - homepage.widgets[1].url=https://uptime-kuma.rubus.home

      - homepage.widgets[1].slug=freshrss

Wanneer je nu de container van FreshRSS opnieuw aanmaakt en opstart, detecteert Homepage de widgets en toont ze bij de service.

Alternatieven voor Homepage

Hoewel Homepage een krachtige tool is, zijn er talrijke alternatieven om een dashboard voor al je services te maken, elk met hun eigen benadering. Houd je niet van YAML-configuraties, dan biedt Homarr een gebruiksvriendelijk alternatief om met slepen en neerzetten allerlei services toe te voegen.

Ook populair is Heimdall. Het is minder naar eigen smaak aan te passen dan Homepage of Homarr, maar daardoor eenvoudig om mee aan de slag te gaan.

Bevalt de aanpak met YAML-bestanden je wel, maar ligt Homepage je niet helemaal, kijk dan eens naar Dashy.

Bookmarks

Tot slot kan Homepage ook gewone bladwijzers aan je dashboard toevoegen. Je kunt ze net op dezelfde manier als services groeperen, maar het zijn slechts links zonder extra functionaliteiten zoals widgets en monitoring. Bladwijzers definieer je in het bestand bookmarks.yaml van Homepage, dat er standaard als volgt uitziet:

- Developer:

  - GitHub:

    - abbr: GH

      href: https://github.com

- Social:

  - Reddit:

    - abbr: RE

      href: https://reddit.com

- Entertainment:

  - YouTube:

    - abbr: YT

      href: https://youtube.com

Vervang deze groepen met bladwijzers door jouw eigen keuzes. Dit is bijvoorbeeld handig om alle links naar portaalsites of accounts bij belangrijke diensten op één pagina te verzamelen. Homepage toont dan per groep een lijst met bladwijzers met hun afkorting (de waarde van abbr), naam en het domein van de link.

Wil je in plaats van een afkorting een pictogram bij een bladwijzer tonen, gebruik dan icon in plaats van abbr en geef daar net zoals bij services de naam van een pictogram op. En vul description bij een bladwijzer in om een beschrijving in de plaats van het domein te zien. Ook de groepen van bladwijzers kun je een pictogram geven. Net zoals voor de groepen van services definieer je die pictogrammen in settings.yaml.

Een volledig dashboard van Homepage met header, services en bladwijzers.

En verder

Homepage biedt nog veel meer mogelijkheden dan we hier kunnen behandelen. Vooral in het bestand settings.yaml zijn er nog allerlei aanpassingen mogelijk. Zo kun je een achtergrondafbeelding instellen en daarop allerlei filters toepassen. Ook het thema en het kleurenpalet, die je beide via pictogrammen onderaan de pagina kunt aanpassen, zijn vast in te stellen.

Ook de lay-out van het dashboard is configureerbaar. Zo neemt standaard elke groep een kolom in, waarbij de services onder elkaar komen te staan. Maar met style: row bij een groep laat je de services in die groep naast elkaar in een rij weergeven. Ook het aantal kolommen, de stijl van de header en nog meer zijn in te stellen.

Homepage is tot in de kleinste details aan te passen.

Speciaal voor de jongste Linux-fans

(dit vinden ze zeker leuk!)
▼ Volgende artikel
Waar voor je geld: 5 mini-pc's als desktop- of laptopvervanger
© ID.nl
Huis

Waar voor je geld: 5 mini-pc's als desktop- of laptopvervanger

In de rubriek Waar voor je geld gaan we op zoek naar producten voor een mooie prijs die je leven makkelijk(er) maken. Werk je vaak thuis, maar is je werkplek niet al te groot? Dan kun je overwegen om een klein formaat pc aan te schaffen. Een mini-pc voldoet aan die behoefte, het enige dat nodig is, is een aparte monitor.

Een mini-pc kan een goede oplossing zijn voor thuiswerkplekken die niet al te groot zijn, of waar je simpelweg gewoon een opgeruimder bureau wil hebben. Mini-pc's zijn compact, maar snel en veelzijdig genoeg om er je gewone werk op te doen of om op te gamen. Wij vonden vijf krachtige mini-pc's voor je.

Acer Revo Box RB102-01W Mini

De Acer Revo Box RB102-01W Mini is een compacte computer die zijn rekenkracht ontleent aan een Intel Core Ultra 5 125U processor. Deze processor is ontworpen om een balans te bieden tussen prestaties en energie-efficiëntie. Voor het uitvoeren van je dagelijkse taken en het wisselen tussen verschillende applicaties beschikt het systeem over 8 GB aan DDR5 werkgeheugen. De opslag van je bestanden, software en het besturingssysteem wordt verzorgd door een 512 GB SSD, wat bijdraagt aan snelle opstart- en laadtijden. Qua connectiviteit kun je gebruikmaken van een reeks poorten. Zo zijn er meerdere USB-aansluitingen beschikbaar voor je randapparatuur. Voor het aansluiten van beeldschermen is de mini-pc uitgerust met zowel een HDMI- als een DisplayPort-uitgang. Om verbinding te maken met een netwerk, is er een 2.5 Gigabit Ethernetpoort aanwezig. Het systeem wordt geleverd met Windows 11 voorgeïnstalleerd.

Specificaties

Formaat: 13,1 x 13,1 x 4,3 cm
Processor:
Intel Core Ultra 5 125U
Werkgeheugen:
8 GB DDR5
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth, 2.5 Gigabit LAN

MSI Cubi 5 12M-002EU

De MSI Cubi 5 12M-002EU is een rappe mini-pc van slechts 12,4 × 12,4 × 5,4 centimeter. Via de bijgesloten VESA-beugel monteer je de behuizing optioneel achterop een pc-monitor. Ondanks het nogal kleine formaat betreft het een volwaardige pc waarop je één of twee schermen kunt aansluiten. Gebruik hiervoor de HDMI- en/of DisplayPort-aansluiting aan de achterzijde. Verder zien we hier twee netwerk- en usb-poorten. Via drie usb-ingangen aan de voorzijde sluit je makkelijk randapparaten aan. Voor draadloze communicatie heeft de binnenzijde een bluetooth- en wifi-adapter.

In het kleine 'doosje' zit een ssd van 512 GB. Hierop is Windows 11 Pro voorgeïnstalleerd. Om die reden leent de Cubi 5 12M-002EU zich goed voor zakelijke gebruikers, want deze Windows-editie beschikt over extra veiligheidsfuncties. De Intel Core i5-1235U-processor voldoet voor dagelijkse pc-taken prima. Deze processor heeft tien rekenkernen waarvan de snelste twee zijn afgeregeld op een maximale klokfrequentie van 4,4 GHz. Tot slot is er een geheugenmodule van 8 GB RAM ingebouwd. Blijkt dat op den duur onvoldoende, dan kun je eventueel upgraden naar maximaal 64 GB RAM. Deze mini-pc is als alternatief ook met meer rekenpower verkrijgbaar.

Specificaties

Formaat: 12,4 x 12,4 x 5,4 cm
Processor:
Intel Core i5-1235U
Werkgeheugen:
8 GB DDR4
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth 5.3, 1x Gigabit LAN, 1x 2.5 Gigabit LAN

Lenovo ThinkCentre M70q Gen 5 Mini PC 

De Lenovo ThinkCentre M70q Gen 5 is een compacte computer die zijn prestaties haalt uit een Intel Core i5-14400T processor. Voor het uitvoeren van je taken en het draaien van software is het systeem voorzien van 16 GB aan DDR5 werkgeheugen. Dit type geheugen heeft een hogere snelheid dan zijn voorganger, DDR4. Als het gaat om de opslag van je bestanden en programma's, dan maak je gebruik van een 512 GB SSD. De aanwezigheid van een SSD is van invloed op de opstarttijd van de computer en de laadsnelheid van je applicaties. Verbindingen met het internet en je lokale netwerk leg je via de ingebouwde Wi-Fi 6 (802.11ax) module of de aanwezige ethernetpoort. Voor het koppelen van randapparatuur zoals een monitor, muis of extern opslagapparaat, beschikt de mini-pc over een variatie aan poorten, waaronder HDMI, DisplayPort en meerdere USB-aansluitingen. Het besturingssysteem dat vooraf geïnstalleerd is, is Windows 11 Pro.

Specificaties

Formaat: 17,9 x 18,3 x 3,7 cm
Processor:
Intel Core i5-14400T
Werkgeheugen:
16 GB DDR5
Harde schijf:
512 GB SSD
Netwerk:
Wifi 6E, Bluetooth 5.3, Gigabit LAN

DELL OptiPlex 3000 Thin Client - N6005

De DELL OptiPlex 3000 in deze Thin Client-uitvoering is een systeem dat is ontworpen voor specifieke computertaken. Het apparaat draait op een Intel Pentium Silver N6005 processor, een chip die de basis vormt voor de functionaliteit. Voor het werkgeheugen is er 16 GB RAM aanwezig, wat van invloed is op de prestaties bij het gebruiken van meerdere programma's. De opslag bestaat uit een SSD met een capaciteit van 256 GB, waarop het besturingssysteem en je applicaties worden geïnstalleerd. Dit model is uitgerust met Dell ThinOS, een specifiek besturingssysteem dat is gericht op het werken met virtuele desktopomgevingen. Voor het aansluiten van je apparatuur beschikt de computer over diverse poorten. Je vindt er onder andere USB 3.2-poorten, een netwerkaansluiting en twee DisplayPort-uitgangen voor het koppelen van beeldschermen. De compacte behuizing maakt het mogelijk om het systeem op verschillende manieren te plaatsen

Specificaties

Formaat: 18,2 x 17,8 x 3,6 cm
Processor:
Intel Pentium Silver N6005
Werkgeheugen:
16 GB DDR4
Harde schijf:
256 GB SSD
Netwerk:
Gigabit LAN

Blackview MP100 Mini PC

Binnen de compacte behuizing van de Blackview MP100 vind je een AMD Ryzen 7 5825U processor, een chip met 8 kernen die de taken van het systeem verwerkt met een maximale turbofrequentie van 4.5 GHz. Voor het gelijktijdig gebruiken van verschillende programma's is het systeem, afhankelijk van de uitvoering, voorzien van 16 GB of 32 GB DDR4 werkgeheugen. Mocht je in de toekomst meer geheugen nodig hebben, dan is dit uit te breiden tot een maximum van 64 GB. De opslag van je bestanden en software wordt verzorgd door een M.2 SSD, met een capaciteit van 512 GB of 1 TB. Qua verbindingen heb je de beschikking over Wi-Fi 6 en Bluetooth 5.2 voor draadloze connectiviteit. Fysieke aansluitingen zijn er ook volop: het apparaat heeft onder andere USB 3.2-poorten, twee Type-C poorten, een HDMI-aansluiting en een DisplayPort. Hiermee kun je tot drie 4K-beeldschermen tegelijk aansturen. Het vooraf geïnstalleerde besturingssysteem op dit model is Windows 11 Pro.

Specificaties

Formaat: 12,8 x 12,8 x 5,2 cm
Processor: AMD Ryzen 7 5825U
Werkgeheugen:
16 GB of 32 GB DDR4
Harde schijf:
512 GB of 1 TB SSD
Netwerk:
Wifi 6, Bluetooth 5.2, Gigabit LAN