Er is weinig leuker om nieuw aan te schaffen dan een hypermoderne televisie! Maar wie denkt dat aansluiten zo gepiept is, heeft het mis. Smart-tv’s hebben namelijk nogal wat aansluitingen in huis. Om over het grote aantal menu-instellingen nog maar te zwijgen. Zo stel je je smart-tv optimaal in!

Tip 01: Kies voor hdmi

Nadat je een smart-tv hebt neergezet of opgehangen, sluit je logischerwijs eerst de benodigde kabels aan. Hoewel moderne toestellen ook component- of zelfs nog composiet-ingangen hebben, gebruik je bij voorkeur hdmi-poorten. Deze standaard is in staat om zowel beeld als geluid in een hoge kwaliteit te transporteren. Wie een receiver (home-cinemaset), soundbar of versterker gebruikt, stopt de kabel in de hdmi-uitgang van dit apparaat. Het andere uiteinde van de hdmi-kabel doe je in de hdmi-ingang van de smart-tv. Kies bij voorkeur de hdmi-ingang waarbij de term arc staat vermeld. In tip 3 gaan we nader op deze interessante technologie in. Gebruik je geen receiver of heeft dit apparaat geen hdmi-uitgang? Je sluit alle audiovisuele randapparatuur in dat geval rechtstreeks op de hdmi-ingangen van de smart-tv aan. Denk bijvoorbeeld aan een decoder (tv-ontvanger), mediaspeler, spelcomputer en/of blu-ray-speler. Gelukkig hebben de meeste smart-tv’s voldoende hdmi-poorten aan boord.

©PXimport

Tip 02: Geluid op speakers

Sommige receivers, soundbars en versterkers hebben geen hdmi-uitgang. Waarschijnlijk zijn de blu-ray-speler en decoder dan rechtstreeks op de televisie aangesloten via hdmi-kabels. Vanzelfsprekend wil je het tv-geluid wel graag over je kwalitatief goede speakers horen. Naast hdmi zijn er gelukkig ook nog andere methodes om het tv-geluid aan de receiver door te geven. Een prima alternatief is de optische s/pdif-uitgang op je smart-tv. De corresponderende ingang is op de meeste receivers aanwezig en kan digitale surround-formaten als dts en dolby digital doorgeven. Oudere receivers en sommige stereoversterkers hebben alleen analoge ingangen. Je kunt het tv-geluid in dat geval via de speakers beluisteren door een tulpkabel aan te sluiten. Let hierbij wel op, want vaak is er aan de televisiezijde een speciale verloopkabel nodig om een analoge verbinding tot stand te brengen.

Tip 03: Arc-verbinding

Bij een traditionele opstelling zijn alle audiovisuele bronnen op de receiver of soundbar aangesloten. De receiver stuurt het beeldsignaal door naar de televisie en regelt zelf de audio-afdracht van een aangesloten blu-ray-speler, decoder of spelcomputer. Vanwege populaire apps als NPO, RTL XL, KIJK, Netflix en Videoland is de smart-tv zelf ook een audiovisuele bron. Ook wanneer je nog naar analoge televisie kijkt of er een interne CI+-module is ingebouwd, genereert de smart-tv zelfstandig audio.

Dit geluid wil je uiteraard eveneens via de receiver en aangesloten luidsprekers afspelen. Gelukkig vereist dat veelal geen aparte kabel, mits zowel de receiver als smart-tv arc (audio return channel) ondersteunen. Bij nieuwe producten is dat meestal het geval. Je dient in de geluidsinstellingen wel aan te geven dat je het geluid via hdmi-arc naar de receiver terugstuurt. Overigens is deze techniek ook nuttig wanneer de receiver te weinig hdmi-poorten bevat voor al je audiovisuele apparatuur. Je sluit bijvoorbeeld een mediaspeler of spelcomputer waarvoor op je reciever geen ruimte meer is, rechtstreeks op de hdmi-ingang van je smart-tv aan, en laat het geluid hiervan terugsturen naar de receiver. Hoewel arc een prachtige techniek is om geluid tegen de richting in terug te sturen, werkt het in de praktijk helaas wisselvallig. Het is dus een kwestie van uitproberen. Is er geen stabiele audioverbinding, dan loont het de moeite om het geluid van apps, analoge zenders of een CI+-module op je smart-tv via een aparte optische s/pdif-kabel naar de receiver over te dragen.

©PXimport

Tip 04: Netwerkverbinding

Een smart-tv vereist altijd een actieve netwerkverbinding. Je hebt die nodig om bijvoorbeeld videostreams vanaf de server van Netflix, YouTube of NPO op te halen. Verder krijgen smart-tv’s ook regelmatig software-updates via internet aangeboden. De meeste toestellen hebben een draadloze netwerkkaart, zodat je het apparaat eenvoudig verbindt met het wifi-netwerk. Hoewel dat om praktische redenen vaak handig is, geniet een bekabelde verbinding de voorkeur. Een draadloze signaaloverdracht is namelijk gevoelig voor storingen en de bandbreedte valt vaak tegen. Aangezien videostreams steeds meer bandbreedte opeisen, is het beter om de televisie via een ethernetkabel met het thuisnetwerk te verbinden. Zo verklein je de kans op hinderlijke haperingen van bijvoorbeeld 4K-streams op Netflix.

Tip 05: Eerste instellingen

Als de benodigde kabels correct zijn aangesloten, is het tijd om de instellingen van de smart-tv onder de loep te nemen. Zodra je het apparaat voor de eerste keer aanzet, beland je doorgaans in een configuratiewizard. Welke instellingen er verschijnen, is per model en televisiefabrikant verschillend. Meestal stel je de taal, tijdzone en netwerkverbinding in. Kies je voor een draadloos netwerk, dan selecteer je de juiste netwerknaam en vul je het bijbehorende wachtwoord in. Wanneer er rechtstreeks een analoge televisiekabel of CI+-module op het toestel is aangesloten, zoekt de smart-tv naar beschikbare zenders. Mogelijk kun je nog de thuis- of winkelmodus (de)activeren en een universele afstandsbediening instellen. Laatstgenoemde optie is bijvoorbeeld een uitkomst wanneer je een decoder met een eigen afstandsbediening gebruikt.

©PXimport

Tip 06: Geluidsinstellingen

Wanneer het configuratiemenu van de smart-tv niet de geluidsinstellingen met je doorneemt, doe je dat handmatig. Het is tenslotte belangrijk om te bepalen op welke wijze je tv het geluid afspeelt. Je opent de instellingen meestal door op het tandwiel van de afstandsbediening te drukken, waarna je de geluidsopties opent. Indien de smart-tv op een receiver of soundbar is aangesloten, geef je aan hoe je het tv-geluid aan dit apparaat doorgeeft. Je hebt meestal keuze tussen hdmi (arc), optisch en analoog (line-out). Luxere modellen kunnen audio via bluetooth op draadloze luidsprekers afspelen. Verder geef je in de instellingen eventueel aan dat je geluid zowel via een aangesloten receiver als op de interne tv-speakers wilt afspelen. Soms kun je in de geluidsinstellingen ook de gewenste audio-uitvoer instellen, zoals dolby digital (plus) en pcm. Laat indien mogelijk deze instelling op de automatische instelling staan, zodat de smart-tv zelf de beste audio-doorvoer selecteert. Wanneer beeld en geluid niet volledig synchroon lopen, pas je tot slot de audiotiming aan door bijvoorbeeld een vertraging in te stellen.

Tip 07: Hdmi-cec

Hdmi-cec (consumer electronic control) is een ietwat lastige term, omdat televisiefabrikanten hiervoor verschillende benamingen gebruiken. Neem nu bijvoorbeeld LG SimpLink, Samsung Anynet+, Philips EasyLink en Sony Bravia Link. Al deze termen komen op hetzelfde neer, namelijk het koppelen van verschillende apparaten via hdmi-cec. Dankzij deze technologie voer je met een enkele opdracht op de afstandsbediening bij diverse apparaten een taak uit. Schakel je de televisie bijvoorbeeld uit, dan zorgt hdmi-cec dat automatisch de receiver en blu-ray-speler ook worden uitgezet. Verder kiest de receiver altijd de juiste bron. Ook het eerder besproken arc is onderdeel van hdmi-cec. Wie deze technologie eens wil uitproberen, activeert in het menu van de televisie de functie. Op een LG-toestel navigeer je bijvoorbeeld naar Alle instellingen / Algemeen / SIMPLINK (HDMI-CEC). Daarnaast activeer je hdmi-cec ook op de aangesloten hdmi-apparaten, zoals een receiver en blu-ray-speler. Er is overigens wel een waarschuwing op z’n plaats. Zodra je producten van verschillende merken aan elkaar koppelt, verloopt de communicatie tussen de apparaten mogelijk minder soepel. Sommige fabrikanten passen deze standaard namelijk naar eigen smaak iets aan. Verder heb je met hdmi-cec minder controle. Wanneer je de televisie inschakelt, springen er tegelijkertijd wellicht apparaten aan die je op dat moment niet wilt gebruiken.

©PXimport

Tip 08: Mobiele app

Bekende televisiefabrikanten bieden voor hun smart-tv’s een mobiele app aan. Hiermee verbind je een smartphone of tablet eenvoudig met de televisie. Zo gebruik je het mobiele toestel bijvoorbeeld als afstandsbediening of stream je persoonlijke video’s naar de smart-tv. Logischerwijs zijn de exacte functies bij ieder merk verschillend. Bezitters van een LG-smart-tv hebben veel profijt van de app LG TV Plus. Hiermee voer je allerlei handelingen op de gekoppelde televisie uit, zoals de volumeregeling, het activeren van de 3D-modus en het opstarten van apps. Met de functie Touchpad bestuur je een muisaanwijzer op het scherm. Het koppelingsproces is vrij eenvoudig. Eerst download je de LG TV Plus-app gratis uit de app-store van Apple of Google. Belangrijk is dat de smart-tv en het mobiele toestel met hetzelfde thuisnetwerk zijn verbonden. De app toont vervolgens de naam van de smart-tv en het bijbehorende ip-adres. Als het goed is verschijnt er op de televisie nu een driecijferige pincode. Deze code neem je over op de smartphone of tablet, waarna beide apparaten met elkaar zijn verbonden.

Tip 09: Smart-tv-apps

Zonder fatsoenlijke apps heb je natuurlijk weinig aan een smart-tv. De kans is groot dat populaire apps al zijn geïnstalleerd, zoals Netflix en YouTube. Kijk vooral ook even in de applicatiewinkel welke toepassingen er nog meer beschikbaar zijn. Zo zijn voor de Nederlandse markt NPO, RTL XL, KIJK, NLziet, Videoland, Pathé Thuis en Spotify interessante apps. Voor de laatste vier genoemde namen heb je overigens wel een geldig abonnement nodig. Verder is Plex een doeltreffend hulpmiddel om eigen video’s vanaf netwerkbronnen te streamen. Ook nieuwsmedia als De Telegraaf, NOS en Nu.nl zijn op de meeste smart-tv’s beschikbaar. Wanneer je een leuke app tegenkomt, kies je simpelweg voor Installeren. De naam van de app verschijnt even later in het menu. Overigens pas je de volgorde van de apps in het menu eenvoudig aan. Het is namelijk uiterst vervelend wanneer je ver moet scrollen om je favoriete toepassing te openen.

©PXimport

Tip 10: Software-update

Televisiefabrikanten voorzien hun smart-tv’s regelmatig van nieuwe software (ook wel firmware genoemd). Deze updates bieden ze via internet aan. Vaak gaat het om verbeteringen of gedichte beveiligingslekken van het besturingssysteem, al komen er ook weleens nieuwe functies beschikbaar. Hoewel veel smart-tv’s automatisch laten weten wanneer er een nieuwe software-update klaarstaat, is dat helaas niet altijd zo. Het is dus verstandig om regelmatig handmatig naar verse updates te laten zoeken. Meestal is deze functie in het instellingenmenu onder de optie Algemeen aanwezig. Je vraagt hier statusinformatie over de televisie op en bekijkt welke softwareversie er momenteel actief is. Als de smart-tv een nieuwe update vindt, installeer je die meteen. Veelal kun je ook aangeven dat je toekomstige updates wél automatisch wilt installeren.

Tip 11: Beeldinstellingen

Een smart-tv heeft nogal wat instellingen in huis om de beeldweergave naar eigen hand te zetten. Is je televisie nieuw, dan is de kans groot dat de standaardbeeldmodus is geoptimaliseerd voor een sterk verlichte winkelomgeving. Thuis is er vaak minder licht, waardoor een te felle beeldweergave storend kan zijn. Reden genoeg om daar even zorgvuldig naar te kijken. Zoek in het menu de beeldinstellingen op. Bij de meeste televisies heb je keuze tussen verschillende beeldmodi. In donkere omgevingen geven Bioscoop of Film vaak het mooiste resultaat in de huiskamer. Verder kun je meestal ook kiezen voor een ecomodus om het stroomverbruik te beperken. Wie specifieke wensen heeft, past de beeldinstellingen desgewenst handmatig aan. Denk hierbij bijvoorbeeld aan het contrast, de helderheid, de kleur(tinten), de kleurtemperatuur en de scherpte. Vaak zijn er ook nog allerlei geavanceerde beeldinstellingen beschikbaar. Het instellen hiervan is doorgaans een vak apart. Wens je voor de beeldinstellingen graag een steuntje in de rug? Er zijn speciale kalibratie-blu-rays verkrijgbaar die je hierbij een handje helpen.

©PXimport

Tip 12: Ouderlijk toezicht

Je stelt bij een smart-tv eenvoudig een leeftijdslimiet in. Zo kunnen (klein)kinderen bijvoorbeeld geen programma’s voor volwassenen zien. Bij de meeste toestellen vind je dit onderdeel binnen het instellingenmenu onder het kopje Veiligheid. Je ontgrendelt de veiligheidsinstellingen door de juiste pincode op te geven. Doorgaans is dat standaard viermaal een nul. Vervolgens stel je een tv-programmavergrendeling in door de maximale leeftijd te selecteren. Verder kun je ook bepaalde kanalen blokkeren en de toegang tot specifieke apps beperken.

Tip 13: Advertentiecookies

Televisiefabrikanten bewaren op je smart-tv zogeheten advertentiecookies. Adverteerders gebruiken deze informatie om te monitoren hoe vaak bepaalde reclame-uitingen worden afgespeeld. Naar zeggen van de fabrikanten, zorgen de advertentiecookies ervoor dat je niet telkens dezelfde reclameboodschappen binnen apps krijgt voorgeschoteld. Daarnaast biedt het adverteerders de mogelijkheid om de reclames af te stemmen op je persoonlijke voorkeuren. Heb je liever niet dat adverteerders met je meegluren? Dan kun je de advertentiecookies gelukkig uitzetten. Je vindt deze optie meestal in de algemene instellingen. Eerder opgeslagen cookies wis je van het systeem en je geeft eenvoudig aan dat de smart-tv geen nieuwe ‘volgbestanden’ mag opslaan.

©PXimport

Tip 14: Toegankelijkheid

Bouwers van smart-tv’s houden in toenemende mate rekening met mensen die problemen hebben met horen of zien. Deze opties zijn binnen de instellingen beschikbaar onder het kopje Toegankelijkheid. Zo is het vaak mogelijk om de vormgeving aan te passen, zodat mensen met visuele beperkingen beter met de gebruikersomgeving overweg kunnen. Op nieuwere smart-tv’s van LG activeer je bijvoorbeeld een grotere muisaanwijzer en schakel je de aanwezigheid van transparante menu’s uit. Hierbij stel je eventueel een lagere bewegingssnelheid van de muisaanwijzer in. Verder kun je ook ondertitels inschakelen, al verschijnen die alleen bij tv-programma’s in beeld die deze functie ondersteunen.

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.