Apple noemt zijn nieuwe AirPods “een unieke combinatie van eenvoud en technologie”. De draadloze oordopjes werken op alle Apple-producten en beloven kwaliteit en comfort zonder een wirwar van draden. Wij mochten testen of Apple zich aan die belofte heeft gehouden.

Design

Van de verpakking tot het kleinste detail op de AirPods zelf, de draadloze oordopjes zijn onmiskenbaar een product van Apple. De AirPods hebben dezelfde kenmerkende witte kleur als de oordopjes die we in de verpakking van de allereerste iPod in 2001 aantroffen.

©PXimport

De bovenkant van de verpakking is gesierd met een reliëf van de AirPods. Bij het openen van het doosje treffen we de oplaadcase aan met daarin de AirPods. De draadloze oordopjes van Apple zien er strak uit en zijn in principe een set EarPods zonder kabel. Waar de kabel normaal gesproken begint, zit een klein zilverkleurig randje met een klein microfoontje voor bellen en opdrachten voor Siri. In de AirPods zit de niewe W1-chip die voor een stabiele verbinding en lange batterijduur moet zorgen. Hier komen we later op terug.

Verbinden

Je verbindt de AirPods met je iPhone of Mac via bluetooth. De AirPods koppelen zich niet alleen aan een apparaat, maar ook aan je iCloud-account. Ik koppelde de AirPods aan mijn iPhone en na het activeren van bluetooth op mijn MacBook, koppelden de oordopjes zich automatisch aan mijn laptop. Deze vlieger gaat echter alleen op als je een iPhone hebt met iOS 10, een Mac met macOS Sierra en natuurlijk een iCloud-account.

©PXimport

Het enige wat ik hoefde te doen om de oordopjes te verbinden, is de oplaadcase openen in de buurt van mijn iPhone. Op het scherm verscheen na een paar seconden een pop-up met de AirPods, waarna ik alleen maar op Verbinden hoefde te drukken. Nadat de AirPods zijn verbonden, kun je bij het openen van de oplaadcase gelijk het batterijpercentage zien van zowel de AirPods als de oplaadcase.

©PXimport

©PXimport

©PXimport

Twee keer tikken

In het Bluetooth-menu van je iPhone kun je ook wat instellingen wijzigen. Zo kun je de naam veranderen van de AirPods en kun je bepalen wat er gebeurt als je twee keer op de AirPods tikt.

©PXimport

Standaard is dubbel tikken een snelkoppeling naar Siri, maar ik vond het pauzeren van muziek een handigere functie. De AirPods worden in je verbonden apparaten weergegeven als AirPlay-apparaat.

Als de oordopjes verbinding maken, hoor je een kenmerken geluid waardoor je weet dat je kan beginnen met luisteren. Deze toon leer je snel te herkennen. De snelheid waarmee de AirPods zich met je apparaten verbindt is werkelijk fenomenaal. Op het moment dat je ze in je oor doet, hoor je vrijwel direct de toon en kun je beginnen met luisteren.

Oordetectie

Er zit een soort sensor in de AirPods, waardoor de oordopjes weten wanneer je ze in hebt. Deze sensor is verbonden aan de nieuwe W1-chip. Oordetectie heeft zo z’n voordelen en z’n nadelen. Het voordeel is dat de AirPods zich gelijk met je dichtstbijzijnde iPhone of MacBook verbinden als je deze indoet. Als je één AirPod uit je oor haalt, stop de muziek. Dit vond ik persoonlijk geen voordeel, aangezien ik de muziek zelf kon pauzeren door twee keer te tikken. Door te klikken op het i-icoon naast de naam van de AirPods, konden we de Oordetectie uitschakelen. Op je Mac doe je dit door bij Bluetooth-voorkeuren op Opties te klikken bij de AirPods. Vervolgens verschijnt er een klein menu, waar je Automatische oordetectie kan uitschakelen.

©PXimport

Door dit uit te schakelen, kon ik gewoon met één oor muziek luisteren en bleef de muziek altijd spelen. Het nadeel is dat de muziek niet stopt als je de AirPod uitdoet, maar dat vond ik persoonlijk geen ramp. Een risico van deze methode is natuurlijk wel dat je AirPods sneller leeg zijn, als je ze vergeet te pauzeren als je ze uitdoet. Tegelijkertijd was dit een eenvoudige methode om gelijk de batterijduur te testen.

Dragen

De AirPods hebben dezelfde vorm als de EarPods die Apple in 2012 introduceerde. Vanaf de iPhone 5 zijn dit de oordopjes die standaard worden geleverd bij alle iOS-apparaten. Het is werkelijk bijzonder dat Apple allerlei functies in de AirPods heeft kunnen verwerken, zonder dat de AirPods zwaarder aanvoelen dan gewone EarPods.

©PXimport

Doordat de AirPods dezelfde vorm hebben, zitten ze net zo lekker, of net zo oncomfortabel als de oordopjes die we gewend zijn van Apple. Bij mij zaten ze goed en bleven ze goed zitten bij het lopen, rennen en zelfs springen. Als je EarPods probleemloos blijven zitten, is de kans groot dat de AirPods ook prima zullen zitten.

Bewegen

Het luxe uiterlijk van de AirPods heeft wel een groot nadeel; de glimmende buitenkant van de oordopjes is glad en totaal niet stroef. Apple heeft geen woord gerept over de eventuele water- of zweetbestendigheid van de AirPods, maar door de textuur zijn ze in ieder geval niet handig bij het sporten. Hoe licht ze ook zijn, als je ze tijdens het sporten gebruikt, glijden ze gegarandeerd uit je oor na de eerste zweetdruppel.

Ik moet wel toegeven, Apple heeft de AirPods nooit gepromoot als sport-oortjes. Daarvoor raadt Apple de Powerbeats3 Wireless Earphones aan. Of we het Apple kwalijk moeten nemen dat de AirPods niet geweldig zijn voor sport, laat ik over aan de lezer.

Bellen

Dankzij de W1-chip weten de AirPods wanneer je iets zegt. Op het moment dat je belt of Siri een opdracht geeft, worden de achtergrondgeluiden weggefilterd door de twee langwerpige microfoons op de AirPods. Deze gaten kennen we al van de normale EarBuds, ze zijn iets groter gemaakt en van een microfoon voorzien.

©PXimport

In rumoerige omgevingen konden we moeiteloos een telefoongesprek te voeren. Onze hoofdredacteur heeft ze ook even getest en kon zelfs moeiteloos een gesprek voeren in de overvolle grote hal van Schiphol. Persoonlijk vind ik het fijn dat de ruisonderdrukking alleen wordt geactiveerd bij het gebruiken van je stem. Hierdoor blijf je wel gewoon omgevingsgeluid horen terwijl je naar muziek luistert. Een eigenschap die ik ook bij de gewone EarBuds heel fijn vind.

Microfoon

In hetzelfde menu waar je op je iPhone en Mac oordetectie kan in- en uitschakelen, kun je ook bepalen welke AirPod er gebruikt wordt als microfoon als je wordt gebeld. Standaard staat deze op automatisch, maar als je er bijvoorbeeld maar eentje draagt op kantoor, kun je met die ene AirPod je oproepen beantwoorden.

©PXimport

Mono

Een opvallend gemis van de AirPods is dat je het geluid niet kunt omzetten naar mono. Als je dus langere tijd eentje draagt en je wil muziek luisteren, hoor je bij sommige nummers maar een half geluid. Dit gemis valt mij op doordat de iPod deze functie voorheen wel had; gericht op slechthorenden en gebruikers die maar één oortje wilden gebruiken.

Muziek

Tijdens het luisteren van muziek klinken de AirPods net zo goed als de eerdere oortjes van Apple. Zowel de hoge-, midden- als lage tonen komen goed tot hun recht en het klinkt allemaal kraakhelder Het was niet hoorbaar of de AirPods tijdens het luisteren naar muziek een duidelijkere ruisonderdrukking had dan de EarPods. Zowel de Air- als EarPods filteren door hun ontwerp op zichzelf ook al wat achtergrondgeluid weg, doordat de geluidsbron iets dieper in je oorschelp zit.

Het draadloos luisteren naar muziek is ideaal. Door het kleine formaat en het gewicht van de AirPods, vergeet je al snel dat je ze in hebt. Dankzij de sterke verbinding kun je probleemloos door de kamer lopen terwijl de muziek gewoon doorspeelt. Tijdens het weglopen van de muziekbron, ontdek ik dat er een belangrijke functie ontbreekt. De AirPods zelf hebben geen volumeregeling. Om de muziek harder of zachter te zetten, en dit geldt ook voor telefoneren, moet je toch de volumeknoppen op je iPhone of Mac gebruiken.

©PXimport

Doordat je met de twee tikken hooguit de muziek kan pauzeren, moet je voor alle andere functies je iPhone of Mac erbij pakken of Siri inschakelen. Doorspoelen, terugspoelen, naar het volgende of vorige nummer skippen; het kan alleen door deze opdrachten aan Siri te vragen. Helaas werkt Siri niet met apps als Spotify, waardoor je alleen iets aan Siri hebt als je muziek luistert in de Muziek-app van Apple zelf. Voor mij was Siri hierdoor niet bruikbaar tijdens het luisteren naar muziek.

Zachter

Door het ontwerp van de AirPod en goede geluidskwaliteit, kun je op een relatief laag volume al volledig genieten van je favoriete muziek. Toen we toch bezig waren met een vergelijking met de EarPod, hebben we gelijk even het volume vergeleken. We kwamen tot een verrassende ontdekking: de AirPods zijn een stuk zachter dan de EarPods. Toen we beide koptelefoons op hetzelfde volume hadden gezet en tijdens hetzelfde nummer wisselen tussen de audiobronnen, bleek de EarPod veel meer geluid in huis te hebben op hetzelfde volume.

©PXimport

Gelukkig maakt dit de AirPod niet té zacht. Met het volume op 50% kun je al volledig genieten van je favoriete muziek en op standje maximaal kun je jezelf evengoed gehoorschade toebrengen. Misschien heeft Apple de AirPod bewust zachter gemaakt om batterij te besparen?

Meter

Tijdens het luisteren van muziek, besloten we te testen hoe sterk de verbinding is tijdens het afspelen van muziek. In een open ruimte kun je tot wel 20 meter verwijderd van je iPhone of Mac blijven doorluisteren. Op het moment dat ik een andere kamer inwandelde en er een muur tussen de verbinding stond, viel het signaal vrij snel weg. Door het hele huis muziek luisteren of een telefoongesprek voeren is er dus niet bij.

Buiten

Als de deur uitlopen, wordt het een ander verhaal. Zonder obstakels als meubels of muren kon ik tot maar liefst 50 meter vanaf mijn iPhone muziek blijven luisteren. Vanaf ruim 50 meter begon de muziek pas te haperen. Toch blijft het de vraag of je de AirPods op zulke afstanden zou gebruiken. De AirPods hebben dusdanig weinig bedieningsmogelijkheden dat je al snel je iPhone of Mac erbij moet pakken.

©PXimport

Batterij

Volgens Apple kunnen we de AirPods tot wel 5 uur onafgebroken gebruiken en in combinatie met de oplaadcase zouden de AirPods tot maar liefst 24 audio kunnen afspelen. We hebben de AirPods getest en ze hebben de 5 uur bijna op de minuut af gehaald. Een halfuurtje opladen in de oplaadcase gaf me genoeg stroom om de rest van de dag nog de AirPods te kunnen gebruiken.

©PXimport

De oplaadcase heeft nog een handig voordeel; door de AirPods hierin te doen als je ze niet gebruikt, raak je ze zelden kwijt! Nadat ik tijdens het testen regelmatig één van de AirPods even een paar seconden kwijt was, leerde ik mezelf aan om ze altijd in de case te stoppen als ik ze uit m’n oor haalde. Doordat de case een stuk opvallender is en iets groter dan een stroomadapter, was ik vrij snel van m’n angst af om de AirPods kwijt te raken.

Prijs

Het prijskaartje van 179 euro was voor veel mensen een pijnpunt toen de AirPods werden aangekondigd. Hoewel het nog steeds een hoop geld is, kan ik na deze testperiode wel meer begrip opbrengen voor de prijs. De AirPods zien er mooi uit en hebben een geweldige batterijduur.

Vergelijkbare oortelefoons zijn niet bijzonder veel goedkoper en Apple heeft niet bepaald een betaalbare reputatie. Door dit mee te nemen in het oordeel, is een krappe 180 euro geen belachelijke prijs. De vraag is of je het er voor over hebt.

Conclusie

De geluidskwaliteit is goed, het design is mooi en de bouw is stevig. De samenwerking met iPhone, iPad en Mac is vrijwel naadloos en dit maakt de AirPods een fijne aanvulling op je Apple-ecosysteem.

Het bereik is buitenshuis meer dan voldoende en ook binnen kun je met de AirPods probleemloos weglopen van je werkplek. Hoewel het beantwoorden van oproepen feilloos werkt, missen de AirPods voor het beluisteren van muziek nog enkele functies.

Ondanks deze punten zijn de AirPods het meest innovatieve product dat Apple in 2016 op de markt heeft gebracht. De batterijduur is bijzonder goed en de oplaadcase is een slimme oplossing. Als je vaak gebruik maakt van Siri, kun je met de AirPods bijzonder veel doen zonder je iPhone te hoeven gebruiken. De AirPods zijn een welkome afwisseling na een periode van eenvoudige upgrades van eerdere producten. Met de draadloze oordopjes laat Apple voor het eerst in lange tijd weer eens zien dat het bedrijf innovatie in huis heeft.

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.