Toen de Toyota bZ4x in de showroom verscheen, bleek de elektrische SUV niet helemaal vrij van kinderziekten. Maar volgens het Japanse merk, dat toch een uitstekende reputatie in stand moet houden, zijn alle problemen met de bouwkwaliteit en sturing van de elektrische aandrijflijn nu verholpen. Tijd voor een test!

©Igor Stuifzand | ID.nl

Eerst even een rondje om de Toyota bZ4x

De Toyota bZ4x Dynamic die wij testen is in de kleur Pacific Blue gespoten. Dat staat ’m chic, maar met deze lak komt het ontwerp van de bZ4x wat ons betreft niet helemaal tot zijn recht. Rond de wielen, de dorpels en de bumpers zitten namelijk robuuste matzwarte ‘stootkussens’, maar die vallen in hun donkerblauwe omgeving nauwelijks op. “Gelukkig niet!”, zul je misschien roepen, maar wij vinden die ongelakte beschermlijsten wel iets robuusts hebben. Het is weer eens iets anders!

©Igor Stuifzand | ID.nl

De Toyota bZ4x oogt groter dan hij daadwerkelijk is. Hij heeft een lengte van 4,69 meter, en dat is nog geen 5 centimeter meer dan de Corolla Touring Sports. Met een hoogte van 1,60 meter torent de bZ4x wel 16,5 centimeter boven die stationwagon uit, natuurlijk deels gedwongen door de batterijmodules die in de vloer van de auto zijn verwerkt.

Gelukkig heeft Toyota van de bZ4x geen windtunnel-eenheidsworst gemaakt. Nu heeft de auto heus wel een betere stroomlijn dan een dichte garagedeur, maar van een Tesla-achtig silhouet is geen sprake. En dat is wel zo verfrissend. Opvallend: de bZ4x heeft geen wisser op de achterruit. De lucht die tussen de twee windgeleiders op de achterste hoeken van het dak stroomt, moet de achterruit droog blazen. Op de snelweg lukt dat wel, maar in stedelijk verkeer blijkt die theorie helaas niet op te gaan.

©Igor Stuifzand | ID.nl

Niet alleen Toyota’s exterieurontwerpers hebben zich met de bZ4x van hun beste kant laten zien, ook de designers van het interieur gaven hun creativiteit de vrije loop. Met zijn hoge plaatsing, bijna helemaal tegen de voorruit aan, springt het digitale instrumentarium meteen in het oog. Je leest alle informatie bóven het stuur af, in plaats van er direct achter. Peugeot gebruikt een soortgelijke lay-out; blijkbaar vinden ze het in Japan een goed idee. Net als wij, want de informatie is gemakkelijk in één oogopslag af te lezen en gaat niet schuil achter de rand van het stuur.

©Igor Stuifzand | ID.nl

Wat ook opvalt, is de mooie afwerking van het dashboard, dat met dezelfde stoffen bekleding is overtrokken als de stoelen. Verder zien we pianolakpaneeltjes en zachte kunststoffen, maar Toyota heeft ook veel minder mooi, goedkoop ogend plastic toegepast.

Het centrale aanraakscherm van het multimediasysteem heeft een formaat van 12,3 inch. Soms is het even zoeken naar de juiste functie; zo blijkt dat alle veiligheids- en rijhulpsystemen juist met de knopjes op het stuur via een display in het instrumentarium te bedienen zijn. Zodra je daar eenmaal achter komt, stel je nooit meer vragen. De rijrichting kan met een druk-/draaiknop op de middentunnel worden geselecteerd.

©Igor Stuifzand | ID.nl

Is de Toyota bZ4x een praktische auto?

Aan leefruimte voor de inzittenden geen gebrek, zeker als je het formaat van de bZ4x in ogenschouw neemt. De auto is 26 centimeter korter dan de Tesla Model Y, en dat maakt 'm natuurlijk automatisch minder ruim. Voorin zit je riant, maar ook achterin is ruimschoots voldoende been- en hoofdruimte. Doordat de portieren breed openzwaaien, is de entree bovendien royaal.

Hoewel een dashboardkastje ontbreekt, kom je voor kleine spulletjes weinig ruimte tekort. Doordat de Toyota bZ4x zijn elektromotor voorin heeft liggen, vind je in de neus geen ‘frunk’. Samen met de laadkabel moet alle bagage achterin. Met de achterbank omhoog heeft de kofferruimte in een inhoud van 452 liter. Toereikend voor je dagelijkse behoeften, maar ook niet meer dan dat. Hoe groot het laadruim is wanneer je de achterbank hebt neergeklapt, geeft Toyota niet op in de brochure. Doordat de achterruit vrij vlak ligt, worden de praktische mogelijkheden van de laadruimte wel enigszins beperkt. De bZ4x mag een aanhangwagen met een (geremd) gewicht van 750 kilo trekken. Ook daarmee zet de bZ4x geen nieuwe maatstaf.

©Igor Stuifzand | ID.nl

Wat kost de bZ4x en wat heeft de auto voor die prijs allemaal te bieden?

Prijzen van de Toyota bZ4x starten bij 47.090 euro. Daarmee zit de fiscale waarde van de auto boven de SEPP-grens en kom je dus niet in aanmerking voor aanschafsubsidie. Bij sommige concurrenten is dat wel het geval. Daar staat echter tegenover dat de Toyota bZ4X vanaf de basisuitvoering al een redelijk complete standaarduitrusting heeft.

De Business-versie heeft bijvoorbeeld automatische airco met twee temperatuurzones, een multimediasysteem met 8-inch touchscreen, adaptieve cruisecontrol en 18-inch lichtmetalen wielen. Standaard op elke bZ4x is Toyota Safety Sense, een veiligheidspakket met verkeersbordherkenning, actieve rijbaanassistentie en pre-collision warning, dat je waarschuwt voor een dreigende aanrijding. Bij de duurste Premium-uitvoering is daar dodehoekbewaking aan toegevoegd.

©Igor Stuifzand | ID.nl

Wij testten de bZ4x in de Dynamic-uitvoering. Deze versie staat voor 52.995 euro in de prijslijst. Boven op de basisuitrusting krijg je in deze versie onder meer een elektrisch bedienbare bestuurdersstoel, stuur- en stoelverwarming, een 360-gradencamera met parkeersensoren voor en achter, een draadloze telefoonlader, een automatisch bediende achterklep en een multimediasysteem met 12,3-inch aanraakscherm en geïntegreerde navigatie. Elke bZ4x heeft af-fabriek een warmtepomp. De standaard boordlader heeft een vermogen van 11 kW.

©Igor Stuifzand | ID.nl

Bij Toyota beginnen de tarieven voor private-lease bij 599 euro per maand (op basis van een contract van 72 maanden en 5.000 kilometer per jaar). Je krijgt de bZ4x dan in de Active-uitvoering, zonder extra’s. Wat interessant is als je de bZ4x privé aanschaft: Toyota biedt 10 jaar fabrieksgarantie, tot een maximum van 200.000 kilometer. Op de batterij blijft de garantie zelfs tot 300.000 kilometer geldig. Geen concurrent die Toyota op garantiegebied kan overtreffen.

©Igor Stuifzand

Wat zijn de concurrenten van de Toyota bZ4x?

De Toyota bZ4x opereert in een populaire en drukbezette hoek van de EV-markt. De auto wordt ingeschaald in het zogenaamde C-SUV-segment, waar ook elektrische modellen als de Volkswagen ID.4, de BMW iX1, de Skoda Enyaq iV, de Nissan Ariya, de Audi Q4 e-tron en de Tesla Model Y actief zijn (hoewel de Skoda en Tesla duidelijk een maatje groter zijn). In de nabije toekomst komt de Renault Scénic E-Tech Electric daar nog bij, terwijl de Cupra Tavascan met een vergelijkbaar formaat een nadrukkelijk sportievere koers vaart.

©Igor Stuifzand | ID.nl

Ook de Subaru Solterra is een concurrent van de Toyota. We noemen dit model even apart, want hij is grotendeels identiek aan de Toyota bZ4x. De Solterra wordt echter uitsluitend geleverd met vierwielaandrijving. Dat wil zeggen: naast de standaard elektromotor op de vooras heeft de Solterra altijd een tweede elektromotor op de achteras. Een versie met enkel voorwielaandrijving is er niet.

In de Solterra, die uiterlijk slechts in detail afwijkt van de Toyota, beschik je over een systeemvermogen van 218 pk. Overigens kan de Toyota bZ4x ook met deze aandrijflijn worden geleverd. Een hoger trekgewicht levert vierwielaandrijving overigens niet op.

©Igor Stuifzand | ID.nl

De accutechniek en aandrijflijn van de bZ4x onder de loep

Toen de Toyota bZ4x op de markt verscheen, bleek de auto niet vrij van kwaaltjes. Veel kritiek ging uit naar de elektrische architectuur: de auto bleek niet in staat om ook maar een beetje in de buurt te komen van de opgegeven WLTP-actieradius. Toyota was veel te voorzichtig geweest met de voor de accu benodigde stroombuffer, gaf het Japanse merk later zelf ook toe. Terwijl de boordcomputer aangaf dat de batterij helemaal leeg was, bleek er in werkelijkheid nog 8 procent stroom in te zitten. Toyota pareerde de aanvankelijke kritiek met een grondige update van de software. Sindsdien springt de bZ4x niet alleen zuiniger om met zijn energie, maar moet hij ook dicht in de buurt kunnen komen van de WLTP-range.

©Igor Stuifzand | ID.nl

Afhankelijk van de gekozen uitvoering kan volgens WLTP-opgave een afstand van 446 tot 512 kilometer op een volle accu worden gereden. Dat verschil zit ’m onder meer in de wielen: de Business en Active staan op 18-inch lichtmetaal, terwijl de duurste Premium-uitvoering op 20 inch staat. Ongeacht de gekozen motorvariant – met enkele 204 pk sterke elektromotor op de vooras of met vierwielaandrijving en 218 pk – beschikt de bZ4x over een batterij met een capaciteit van 71,4 kWh. Volgens de lijst met technische specificaties bij de testauto, is daarvan 64 kWh bruikbaar.

Laden doet de bZ4x met een maximumvermogen van 150 kW. Van 10 naar 80 procent aan de DC-snellader neemt 30 minuten in beslag, met 11 kW aan een AC-lader duurt het zes uur en drie kwartier om de batterij helemaal op te laden. Onhandig is de positie van de laadpoort: bij het linker voorwiel. Je moet dus altijd op zoek naar een laadpaal links van de auto, of eentje bij een parkeerplaats waar je vooruit naartoe kunt rijden.

©Igor Stuifzand | ID.nl

Hoe presteert de Toyota bZ4x op onze standaard verbruiksronde?

Toyota communiceert zelf geen verbruikscijfers voor de bZ4x, dus hebben we deze opgezocht op basis van het kenteken van de testauto. Volgens de gegevens van de RDW is het WLTP-verbruik vastgesteld op 14,7 kWh/100 km. Dat wordt nog een hele uitdaging om tijdens de verbruiksronde te evenaren, maar de omstandigheden zijn de Toyota gunstig gezind.

Het is een lichtbewolkte zomeravond met weinig wind, en de temperatuur schommelt tussen de 18 en 19 graden Celsius. De airco van de Toyota hoeft dus nauwelijks iets te doen. Op die airco zit ook een Eco-functie, voor een (nog) lager energieverbruik. Die komen we in andere testauto’s zelden tegen, dus laten we die knop tijdens de testronde onbenut.

Met een knopje links naast de keuzeschakelaar voor de rijrichting kan ‘one-pedal driving’ worden geactiveerd. Die functie gebruiken we wel. Overigens komt de bZ4x bij het lossen van het acceleratie-/deceleratiepedaal niet geheel tot stilstand. Je moet het rempedaal dus alsnog gebruiken om helemaal tot stilstand te komen.

©Igor Stuifzand | ID.nl

Tot ongeveer halverwege de testroute blijft het verbruikscijfer op de boordcomputer keurig rond de 15,0 kWh/100 km schommelen. Maar dan draaien we de snelweg op en zetten we de adaptieve cruisecontrol op 130 km/u. Hogere snelheden betekenen een hoger energieverbruik: we zien op de boordcomputer dat het gemiddelde verbruik binnen 20 snelwegkilometers is opgelopen naar 16,8 kWh/100 km. Blijkbaar kost het de bZ4x heel veel energie om zich een baan door de atmosfeer te werken. Cijfers van TravelCard beamen dat: op www.praktijkverbruik.nl wordt voor de Toyota bZ4x een praktijkgemiddelde van 22,2 kWh/100 km opgegeven, gemeten over het volledige jaar.

Wanneer we de snelweg verlaten en via provinciale buitenwegen (80 km/u) en nog een stuk snelweg (met de cruisecontrol op 100 km/u) richting het eindpunt van de verbruiksronde rijden, zien we dat de boordcomputer is teruggezakt naar een gemiddelde van 15,2 kWh/100 km. Dat noteren we als resultaat. Op basis van een netto batterijcapaciteit van 64 kWh ligt daarmee een range van 422 kilometer binnen bereik. Rijd je echter veel snelwegkilometers, dan moet je met de bZ4x toch ernstig rekening houden met een aanzienlijk hoger stroomverbruik en een veel kleinere actieradius.

©Igor Stuifzand | ID.nl

En hoe bevalt de Toyota bZ4x op de weg?

Wanneer je voor het eerst achter het stuur van de bZ4x stapt, is het even wennen aan de hoge positie van het instrumentarium. Je ziet echter al snel het voordeel ervan in: alle primaire informatie is overzichtelijk in je blikveld geclusterd. Met de software-update is bij de gegevens over de batterijvulling ook de stroomreserve in procenten toegevoegd; aanvankelijk werd dat alleen aangeduid in kilometers.

De bediening van het multimediasysteem via het centrale 12,3-inch aanraakscherm laat zich snel en gemakkelijk doorgronden. Helemaal foutloos is de software echter nog niet, want in de testperiode begon de navigatie regelmatig Engels te praten. We kregen tussentijds zelfs een keer een aanwijzing in een Scandinavische taal voorgeschoteld.

©Igor Stuifzand | ID.nl

Belangrijkste pluspunt van de Toyota bZ4x is zonder meer zijn rijcomfort. Je zit in een erg fijne stoel die je lijf op de juiste plekken een goede ondersteuning geeft. Klein missertje, maar dan leggen we veel zout op een arm slakje: de armleuningen in de deurpanelen en op de middentunnel zitten niet precies op dezelfde hoogte. Daardoor zit je nooit helemaal ontspannen en loop je na een lange rit kans op een verkrampte schouder of nekspier.

Nu we toch in de zeurmodus zitten: vanuit de wielkuipen en rond de omlijsting van de voorruit steken betrekkelijk veel rijgeluiden de kop op. Daardoor loopt de algehele comfortbeleving toch een klein deukje op.

Jammer, want het onderstel van de Toyota bZ4x is van hoge kwaliteit. Het kost veel autofabrikanten de grootste moeite om de invloed van het zware accupakket op het rijgedrag goed onder controle te krijgen, maar bij de bZ4x is dat Toyota absoluut goed gelukt. Op glooiingen in het wegdek voel je de auto soepel in- en uitveren, zonder dat hij gaat deinen. Daar staat tegenover dat de schokdempers de wielen bij korte hobbels en op scherpe hobbels keurig in bedwang houden, zonder te gaan slaan.

Ook de besturing is erg prettig, met een mooie dosering van de tegendruk als je van richting verandert. Veel contactgevoel met de voorwielen is er niet, maar je wijkt bij het indraaien van het kleine stuurtje zelden van de ingeschatte lijn. De bZ4x is geen auto die tot gooien en smijten uitnodigt, maar als je een keer een wat sneller bochtje meepikt, hoef je heus niet alle zeilen bij te zetten om uit de berm te blijven. De bZ4x is een erg prettige reisauto, die echter nóg fijner zou zijn met een wat betere geluidsisolatie. En armleuningen die recht werden gezet…

©Igor Stuifzand | ID.nl

Met de herfst in aantocht dwarrelen de bladeren weer massaal naar beneden – en niet zelden belanden ze in je dakgoot. Samen met ander vuil kan dat de afvoer verstoppen, vooral bij nat weer. Om lekkages en andere problemen te voorkomen, is het verstandig je dakgoot regelmatig schoon te maken. Maar hoe pak je dat aan?

Lees ook: 🍂 Herfstklus: zo maak je je tuinmeubilair winterklaar

Gereedschap: wat heb je nodig?

Voor het doorspoelen van je dakgoten is een tuinslang onmisbaar. Monteer hier een dakgootreiniger op: een opzetstuk met borstel en harkje waarmee je vuil verwijdert en de goot grondig schoonmaakt. Met een telescoopsteel kun je zelfs vanaf de grond werken – handig en veilig. Toch is het slim om af en toe de ladder te nemen, zodat je goed kunt zien wat je doet en geen hoeken overslaat.

Lees ook: Zo werk je veilig in de hoogte met een ladder

Handschoenen zijn een must, of het nu tuinhandschoenen of huishoudhandschoenen zijn. Draag daarnaast oude kleding met lange mouwen, want het water dat uit de goot spat is meestal niet schoon.

Hoe vaak en wanneer schoonmaken?

Eén keer per jaar je dakgoot reinigen is meestal genoeg. Woon je echter tussen veel bomen, dan kun je beter wat vaker aan de slag. Meer blad betekent immers meer kans op verstopping. De beste periode voor de grote schoonmaak is het late najaar: als het niet meer vriest en de meeste bladeren gevallen zijn. Net na een regenbui werkt het schoonmaken makkelijker, omdat het vuil dan losser ligt. Je kunt de goot ook zelf natmaken met de tuinslang.

©bildlove

Stappenplan voor een schone dakgoot

Voordat je begint: veiligheid eerst! Gebruik een stevige ladder die stabiel op een vlakke ondergrond staat. Draag kleding die vies mag worden (bijvoorbeeld een oud shirt met lange mouwen, een stevige broek en rubberen handschoenen) zodat je beschermd bent tegen vuil en scherpe randen.

1 - Verwijder grof vuil

Gebruik een plastic schep, gootschep of oude spatel om bladeren, takjes en ander afval uit de goot te halen. Leg een zeil op de grond of gebruik een emmer of vuilniszak om het netjes te houden. Heb je vooral droog blad in de goot liggen, dan kan een bladblazer met speciaal opzetstuk ook uitkomst bieden.

2 - Spoel alles goed door

Spoel de goot en regenpijp door met een tuinslang, van het ene uiteinde naar het andere. Zo controleer je meteen of het water goed doorstroomt. Blijft er vuil achter, gebruik dan een schuurspons of staalborstel om het te verwijderen.

3 - Controleer op verstoppingen en schade

Kijk tijdens het schoonmaken of er geen blokkades in de afvoerpijp zitten. Gebruik eventueel een ontstoppingsveer. Controleer ook de staat van de goot zelf: scheuren, losse verbindingen of roestige beugels kun je beter direct repareren of vervangen.

4 - Onderhoud op de lange termijn

Een jaarlijkse schoonmaakbeurt houdt je dakgoot in goede conditie. Zo voorkom je dat water blijft staan of in huis doordringt, wat schimmel of vochtproblemen kan veroorzaken.

5 - Maak je dakgoot winterklaar

Voordat de vorst invalt, is een extra controle aan te raden. Blokkades kunnen in de winter leiden tot ijsvorming en schade aan de goot.

©Tomasz Zajda

Veilig werken op hoogte

Zorg altijd voor een stevige, stabiele ladder op een vlakke ondergrond. Draag schoenen met grip en overweeg een veiligheidsharnas bij hogere daken. Is de ladder nat, wacht dan tot deze droog is. Laat bij voorkeur iemand in de buurt blijven terwijl je werkt.

Slimme tips voor een blijvend schone goot

Bladvangers helpen, maar houden niet alles tegen. Klein vuil kan alsnog ophopen en zelfs mosgroei veroorzaken. Bevestig tijdens het schoonmaken je emmer of vuilniszak aan de ladder, zodat je beide handen vrij hebt. Laat je het vuil liever op de grond vallen, dan moet je later nog opruimen – extra werk dus.

Een hogedrukreiniger kan handig zijn, maar gebruik een lage stand om schade te voorkomen. Een gewone tuinslang met een goede sproeikop werkt vaak net zo goed.

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.

⬇️ 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:

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 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:

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.

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.

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

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:

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.

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.

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.

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.

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.