Wat kost een e-bike eigenlijk per jaar of per maand? Want met alleen de aanschaf van de fiets ben je er niet. Je moet hem ook geregeld opladen, netjes onderhouden en eventueel verzekeren. Alvast een spaarpotje aanleggen voor een nieuwe accu is trouwens ook handig, want die is na zo’n vier tot zes jaar aan vervanging toe. Om al die kosten overzichtelijk te krijgen, geven we je een paar voorbeeldberekeningen zodat jij weet waar je aan toe bent en waar je eventueel op kunt besparen.

E-bikes zijn er al vanaf minder dan 1000 euro tot ver boven de 7000 euro. Je kunt het zo gek maken als je zelf wilt. De populairste prijsklassen liggen rond de 2000 en 3500 euro. De gemiddelde prijs van een e-bike lag vorig jaar (2021) op 2400 euro.

Voor onze voorbeeldberekeningen gaan we uit van een stadsfiets van 2000 euro, een luxe stadsfiets of hybride fiets van 3500 euro en een sportieve vrijetijdsfiets van 5000 euro.

Voorbeeld 1: Gazelle Esprit HFB kopen? | Elektrische stadsfiets

Deze stadsfiets van 2000 euro heeft een voorwielmotor en een accu van 450 Wh. Volgens de fabrikant kom je op een volle accu tussen de 40 en 75 kilometer ver. Dat is afhankelijk van de hoeveelheid ondersteuning die je gebruikt. Hoeveel kilometer je in de praktijk haalt valt vaak wat tegen, dus wij gaan voor de berekening uit van een gemiddelde range van 50 kilometer.

Die afstand nemen we meteen als gemiddelde afstand die je per week fietst. Als je alleen doordeweeks fietst, komt dat neer op 10 kilometer per dag.

Voorbeeld 2: Explore E+ 1 625Wh Stagger (2022) | Trekking Fiets | Giant Bicycles Nederland (giant-bicycles.com)

Nemen we een wat luxere fiets van 3500 euro die je in de stad gebruikt en waarmee je ook tochtjes maakt, dan wil je een wat groter bereik, dus een grotere accu is wel zo prettig. Deze fiets heeft een middenmotor en een accu van 625 Wh. Daarmee zou je in de praktijk wel zo’n 75 tot 100 km ver moeten komen. Voor onze berekening houden we 75 kilometer per week aan.

Voorbeeld 3: Upstreet3 | FLYER E-Bikes (flyer-bikes.com)

Voor 5000 euro heb je een heel luxe fiets met een veel krachtiger motor die het ook goed doet in heuvelachtiger terrein. Bijkomend voordeel is dat dergelijke fietsen vaak een hoger gewicht aankunnen. Handig als je zelf iets meer weegt of als je veel vakantiespullen wilt meenemen. Met een accu van 750 Wh kom je in Nederland zeker meer dan 100 km ver, of je moet alleen maar de Vaalserberg op- en afrijden. Laten we voor deze fiets uitgaan van 100 kilometer per week. We zijn per slot van rekening fanatieke fietsers!

Stroomkosten

Dan de stroomkosten. De energieprijzen zijn sinds eind vorig jaar omhoog geschoten. Jouw stroomprijs is afhankelijk van welk contract je hebt afgesloten en hoelang die stroomprijs nog geldt. Aangezien de meeste mensen al hebben moeten verlengen voor een veel hoger tarief of dat binnenkort moeten doen, gaan we uit van de prijzen die je de laatste maanden ziet. Die liggen zo tussen de 50 en 70 cent per kWh, dus wij rekenen met een gemiddelde van 60 cent per kWh.

Om te berekenen hoeveel stroom je per jaar verbruikt aan het opladen van je accu, moet je rekening houden met laadverliezen van je acculader. Niet alle stroom uit de muur komt daadwerkelijk in je accu; er gaat altijd wat verloren aan warmte. Dat kan oplopen tot zo’n 15 tot 25 procent. Laten we voor nu uitgaan van 20 procent verlies.

Bij de stadsfiets kom je 50 kilometer ver op een acculading, en dat rijd je ongeveer per week. Per jaar moet je dan 52 keer opladen. De capaciteit van de accu is 450 Wh, met 20 procent verlies is dat 540 Wh aan verbruikte stroom per volle accu. Vermenigvuldig je dat met 52, dan kom je aan iets meer dan 28 kWh. Elke kWh kost 60 cent, dus per jaar kost je e-bike je nog geen 17 euro. Dat valt heel erg mee, toch?

Het rekensommetje van de wat luxere fiets met 625Wh-accu en 75 km per week komt uit op een kleine 24 euro. De fiets met 750Wh-accu en 100 km per week kost je per jaar ruim 28 euro. Vergelijk dat maar eens met een zuinige auto. Stel, die rijdt 1 liter benzine op 20 km, dan kost die auto je bij 5000 km rijden al snel zo’n 600 euro aan benzine.

Verzekering

Waarom zou je je fiets willen verzekeren? Het is sowieso niet verplicht. Heb je een WA-verzekering (tegenwoordig heet dat een AVP of Aansprakelijkheidsverzekering Particulieren), dan ben je gedekt voor schade die je anderen toebrengt.

De belangrijkste reden om je elektrische fiets te verzekeren, is diefstal. Niet alleen van de fiets zelf, maar ook van de accu, want ook die is kostbaar. Dus als e-bikes bij jou in de buurt regelmatig worden gestolen, is zo’n diefstalverzekering geen overbodige luxe. Check je verzekering of jouw garage of schuur waar je je fiets bewaart onder jouw inboedelverzekering valt. Soms moet je daar nog een extra module voor afnemen en kan worden gevraagd om je fiets ook in je eigen opslag op slot te zetten.

Behalve diefstal wil je misschien ook schade aan je fiets verzekeren, voor het geval je er een ongelukje mee krijgt. Je kunt zelfs pechhulp erbij verzekeren, zodat je geholpen wordt bij pech onderweg.

Let bij het uitzoeken van een verzekering op de looptijd van de verzekering, de dekking en de polisvoorwaarden. Hoe langer je jezelf vastlegt, hoe lager de maandpremie. Vaak kun je kiezen voor looptijden van drie of vijf jaar of voor onbepaalde tijd. De premie betaal je per maand, soms per jaar of zelfs in één keer als je een pakket van drie of vijf jaar afneemt.

Wat betreft de dekking kun je naast diefstal ook schade, pechhulp, ongevallen- en rechtshulpdekking kiezen. Let goed op de voorwaarden van de verzekeraar. Na een aantal jaar vervalt de nieuwwaardedekking, je eigen risico kan verschillen en vaak moet je een ART-2 of hoger goedgekeurd slot hebben en bij diefstal twee sleutels inleveren waarbij één sleutel echt gebruikt moet zijn. De voorwaarden kunnen per verzekeraar behoorlijk wisselen dus het is verstandig om je vooraf goed in te lezen en te vergelijken.

Accu vervangen

Na een aantal jaar is je accu versleten. Hoe snel dat gebeurt, hangt helemaal af van je gebruik en hoe je ermee omgaat. Reken erop dat fietsaccu’s vanaf vier tot zes jaar minder range geven. Dat hoeft niet erg te zijn en je kunt er nog jaren probleemloos mee doorfietsen. Maar op een gegeven moment ben je het zat en dan sta je voor de keuze: een nieuwe accu, de accu laten reviseren of een nieuwe fiets? Een accu vervangen is sowieso goedkoper dan een nieuwe fiets, en zeker als je verder nog heel tevreden bent met je huidige fiets, is dat de beste optie.

De 450Wh-accu van de stadsfiets kost los ongeveer 400 euro. Die van de wat luxere fiets met een 625Wh-accu kost ongeveer 800 euro. De 750Wh-accu gaat al richting de 1000 euro. Dat zijn dus wel kosten die je van tevoren goed mee moet rekenen en waar je het liefst al een potje voor aanlegt, zodat je na een paar jaar niet voor onaangename verrassingen komt te staan. In onze berekening gaan we ervan uit dat de accu vijf jaar meegaat en je daarna een nieuwe wilt kopen.

Onderhoud

Je fiets heeft natuurlijk ook onderhoud nodig. Denk aan nieuwe banden en remblokjes, maar ook afstellen en smeren. Fiets je meer kilometers, dan heb je meer onderhoud nodig. Dat onderhoud kun je zelf doen en daarmee bespaar je natuurlijk geld. Vaak zit de eerste servicebeurt inbegrepen bij de aanschaf van je nieuwe fiets. De nieuwere fietsen met meer snufjes, zoals automatische versnellingen, krijgen regelmatig updates, net als je telefoon.

Soms kan dat via je smartphone en soms alleen via specialistische apparatuur van de merkdealer. Ben je niet zo handig, dan kun je het best naar de fietsenmaker gaan. Doe je het onderhoud helemaal zelf, dan ben je per jaar hooguit een paar tientjes kwijt.

In de beginjaren zijn de onderhouds- en vooral slijtagekosten minder dan als je fiets al een paar jaar oud is. Een onderhoudsbeurt bij de fietsenmaker kost je ergens tussen 65 en 100 euro. Voor onze berekening houden we per jaar 75 euro voor de stadsfiets aan, 100 euro voor de luxere fiets en 125 euro voor de duurste fiets, die ook de meeste kilometers maakt.

Kostenplaatje

We rekenen alles om naar vijf jaar gebruik. Dat is een redelijke termijn om de accu te vervangen en komt de vraag of je een nieuwe fiets wilt kopen of nog een keer in een accu investeert en verder fietst. Onze stadsfiets kost de eerste vijf jaar 375 euro aan onderhoud, ruim 84 euro aan opladen en 390 euro aan een uitgebreide verzekering met pechhulp. Inclusief de aanschaf van de fiets kom je dan uit op 2850 euro. Dat is omgerekend 22 cent per kilometer. Reken je een extra accu erbij, dan kom je uit op 3250 euro en 25 cent per kilometer. Rijd je er dan nog vijf jaar mee verder, dan ben je voor die tien jaar ongeveer 4100 euro inclusief opladen, verzekering en onderhoud kwijt. Dat is 16 cent per kilometer. Langer doorrijden is dus duidelijk voordelig!

Bij de duurdere fietsen zien we hetzelfde plaatje. De luxe stadsfiets kost in vijf jaar ongeveer 4700 euro en omgerekend 24 cent per kilometer, of met extra accu 5500 euro en 28 cent per kilometer. Rijd je dan nog eens vijf jaar door, dan geef je in die tien jaar ongeveer 6675 euro uit, wat neerkomt op 17 cent per kilometer.

Dat kleine verschil in kilometerprijs na tien jaar zien we ook bij de duurste fiets. Daarmee ben je na vijf jaar ruim 6500 euro kwijt, wat neerkomt op 25 cent per kilometer. Na tien jaar heb je bijna 9100 euro uitgegeven, maar omgerekend in prijs per kilometer kom je eveneens uit op 17 cent. Dat komt doordat er meer kilometers mee worden gefietst. Hoe meer je fietst, hoe goedkoper dat per kilometer is.

Na vijf jaar heb je ongeveer 30 tot 40 procent van de nieuwwaarde van je fiets uitgegeven aan variabele kosten. En dan moet je nog een potje erbij sparen voor een nieuwe accu. Duidelijk is wel dat het veel geld kan schelen om lang met je fiets te doen!

Leasen of kopen?

Nu we de kosten goed in kaart hebben, is het makkelijk om te vergelijken of leasen misschien een interessante optie is. Het grote voordeel van een fiets leasen is dat je geen groot bedrag in een keer hoeft uit te geven. Je bepaalt een vast bedrag per maand, al moet je je vaak wel voor meerdere jaren vastleggen. Onze stadsfiets kost in de lease bijvoorbeeld 72 euro per maand voor een contract van drie jaar. Daar zit dan al een uitgebreide verzekering bij, dus daar hoef je je geen extra kosten voor te maken. Voor een tientje extra per maand koop je ook de reparatiekosten af.
Als je dat omrekent, dan ben je na die drie jaar ongeveer 3000 euro kwijt. Je kunt iets besparen door zelf het onderhoud bij de fietsenmaker te laten doen, maar dan nog ben je na drie jaar net zo veel geld kwijt als de fiets zelf kopen en hem vijf jaar lang gebruiken. Leasen is dus niet voordeliger.

Subsidies en werkregelingen

Ben je in loondienst, dan zijn er manieren om goedkoper aan je fiets te komen. Dat hangt wel af van de mogelijkheden die je werkgever biedt, want die moet hieraan willen meewerken. In plaats van zelf een fiets te leasen, kun je dat via je werkgever doen, als die die mogelijkheid biedt. Dan betaalt je werkgever de leaseprijs en wordt de waarde van de fiets voor 7 procent bij je inkomen opgeteld. Daar betaal je inkomstenbelasting over. Addertje onder het gras is wel dat je verder geen werkkilometers meer kunt declareren. Je wordt immers geacht die met je fiets te maken.

Een andere mogelijkheid is de fiets te betalen uit de ruimte die de WKR, de WerkKostenRegeling biedt. Afhankelijk van je arbeidvoorwaarden en je werkgever kun je dan je fiets betalen van je brutoloon, of je levert vakantiegeld, eindejaarsuitkering, vakantiedagen of overuren in. Er wordt geteld met brutobedragen, dus netto ben je dan voordeliger uit dan wanneer je de fiets helemaal zelf van je nettoloon koopt.

Let wel op, er zit wel een maximum aan het bedrag waar je belastingvoordeel op krijgt. Daarboven betaal je het volle pond. Check dus bij je werkgever naar de mogelijkheden en reken alles vooraf goed door! Veel op het oog interessante fietsplanprojecten zijn in de praktijk toch minder voordelig dan gewoon zelf de fiets kopen en de verzekering het onderhoud regelen.

Microsoft heeft een flinke aanscherping van de beveiliging in Windows 11 aangekondigd. Onder de noemer Windows Baseline Security Mode en User Transparency and Consent krijgen gebruikers meer grip op wat apps precies uitspoken op hun computer. Voor de gemiddelde thuisgebruiker betekent dit vooral dat Windows meer gaat lijken op de overzichtelijke beveiliging die we al kennen van onze smartphones.

De aanleiding voor deze verandering is de toenemende irritatie over apps die ongevraagd instellingen aanpassen, extra software installeren of zonder duidelijke toestemming toegang krijgen tot persoonlijke gegevens. Microsoft wil met deze update de regie teruggeven aan de gebruiker, waarbij transparantie en toestemming de belangrijkste uitgangspunten zijn.

Meer grip op je privacy

Een van de meest zichtbare veranderingen is de manier waarop apps om toestemming vragen. Waar programma's in Windows voorheen vaak automatisch toegang hadden tot bepaalde mappen of functies, gaat Windows 11 nu actiever om bevestiging vragen. Wil een app je camera, microfoon of specifieke bestanden gebruiken? Dan verschijnt er een duidelijke melding in beeld, vergelijkbaar met de pop-ups op een iPhone of Android-toestel.

Het mooie van dit systeem is dat je deze keuzes altijd weer kunt terugdraaien. In de instellingen van Windows komt een overzicht waar je precies ziet welke app waarvoor toestemming heeft. Vertrouw je een programma niet langer, dan trek je met één handeling de toegang tot je bestanden of hardware weer in.

©Garun Studios - stock.adobe.com

Alleen veilige software door Baseline Security

Verder introduceert Microsoft de Windows Baseline Security Mode. Dit is een technische beveiligingslaag die ervoor zorgt dat het systeem continu controleert of de software die draait wel integer is. In de praktijk betekent dit dat Windows alleen nog apps, stuurprogramma's en diensten toestaat die officieel zijn ondertekend en als veilig bekendstaan.

Dit voorkomt dat schadelijke software op de achtergrond wijzigingen aanbrengt in je systeem zonder dat je het doorhebt. Voor de meeste mensen verandert er weinig in het dagelijks gebruik; bekende software van grote ontwikkelaars blijft gewoon werken. Mocht je toch een specifiek programma willen gebruiken dat niet aan de strengste eisen voldoet, dan behoud je als gebruiker (of systeembeheerder) de mogelijkheid om handmatig een uitzondering te maken.

Wat merk je in de praktijk?

De uitrol van deze functies gebeurt stap voor stap. Microsoft neemt hier de tijd voor, zodat alles goed blijft werken op de miljarden computers waar Windows op draait. Om dit soepel te laten verlopen, zijn ze op dit moment vooral in overleg met bekende softwaremakers zoals Adobe en 1Password. Zo weet je zeker dat hun programma's gewoon blijven werken onder de nieuwe regels, nog voordat jij de update krijgt. Ook voor de opkomst van slimme AI-hulpjes zijn deze aanpassingen belangrijk. Omdat deze assistenten steeds vaker zelfstandig klusjes voor je opknappen, is het fijn dat je precies kunt zien en bepalen wat zo'n hulpje wel en niet mag doen op jouw pc. 

Kortom: Windows 11 wordt een stukje strenger, maar daardoor ook een stuk transparanter. Je zult iets vaker een vraag krijgen of een app ergens bij mag, maar je krijgt daar een veiliger gevoel en meer controle voor terug.

Als je services op je eigen thuisserver draait, wil je daar ook eenvoudig meldingen van kunnen ontvangen. Ntfy stelt je in staat om eenvoudig pushnotificaties naar je telefoon of computer te sturen. Bovendien kun je ntfy op je eigen thuisserver draaien, zodat je alles in eigen handen hebt. In dit artikel gaan we ermee aan de slag.

Netwerkmonitoringsoftware, een programma dat je Docker-containers bijwerkt, een smarthomecontroller, back-upsoftware, ze hebben allemaal één ding gemeen: ze moeten je meldingen kunnen sturen als er iets gebeurt. Dat kan op verschillende manieren: via e-mail, instant messaging of pushnotificaties naar je telefoon. Dat laatste verloopt doorgaans via een gecentraliseerde dienst zoals Firebase Cloud Messaging (voorheen Google Cloud Messaging) of Apple Push Notification service.

Pushnotificaties zijn handig omdat ze bijna onmiddellijk aankomen en omdat zowel Android als iOS toestaan om in te stellen hoe je ervan op de hoogte wordt gebracht. Wil je pushnotificaties kunnen ontvangen zonder een server onder controle van een partij zoals Google of Apple, dan moet je ook hiervoor je eigen service installeren. Een opensource-project dat dit implementeert, is ntfy.

Werking van ntfy

Je ntfy-server ontvangt meldingen van je programma's via http over een REST-API en zet deze om in pushnotificaties voor de bijbehorende Android- of iOS-app of voor een webpagina op je computer. De API is in de documentatie van het project beschreven, zodat je ook je eigen software met ntfy kunt laten praten. Het project heeft ook een command-line-interface, zodat je bijvoorbeeld shellscripts op je Linux-server eenvoudig pushnotificaties kunt laten verzenden.

Ntfy gebruikt het bekende publish/subscribe-patroon. Een zender publiceert notificaties op een specifiek onderwerp door data te sturen naar een url via een http POST- of PUT-aanvraag. Het onderwerp wordt gedefinieerd door een segment van de url dat volgt op de domeinnaam. Een ontvanger kan zich dan abonneren op dit onderwerp. Elke keer dat de zender daarna een notificatie op dit onderwerp publiceert, stuurt ntfy de data naar alle ontvangers die zich op dit onderwerp hebben geabonneerd. Door ntfy op je eigen server te installeren, heb je de volledige controle over deze notificaties.

Serververeisten

De mobiele app van ntfy moet met je server kunnen communiceren om te vragen of er notificaties zijn. Als je ntfy op een server in je lokale netwerk installeert, moet die dus van buitenaf bereikbaar zijn. Dat kun je met portforwarding in je modem regelen of door je telefoon buitenshuis automatisch met een VPN-server op je lokale netwerk te laten verbinden. Heeft je internetaansluiting thuis geen vast ip-adres, dan moet je ook een DynDNS-updater te draaien.

Een andere optie is om ntfy op een VPS (Virtual Private Server) te installeren. Hierop draai je dan ook een reverse proxy voor https-toegang, die een TLS-certificaat van Let's Encrypt opvraagt. Je hebt dan een domein nodig, waarvoor je een DNS A-record naar het ip-adres van je server laat verwijzen. In de rest van dit artikel gaan we uit van een installatie van ntfy op een lokale server met Debian 13 ("trixie") met behulp van Docker Compose.

Basisconfiguratie

Creëer eerst enkele directory's voor ntfy:

$ mkdir -p containers/ntfy/{cache,etc,lib}

Creëer dan het bestand containers/ntfy/etc/server.yml met de volgende configuratie voor ntfy:

base-url: "https://ntfy.example.com"

cache-file: "/var/cache/ntfy/cache.db"

attachment-cache-dir: "/var/cache/ntfy/attachments"

auth-file: "/var/lib/ntfy/user.db"

auth-default-access: "deny-all"

Vervang het domein achter base-url door het domein waarop je ntfy-server draait. Als je gebruikmaakt van een reverse proxy, dan moet dit de url zijn die door de proxy naar ntfy wordt doorgestuurd. Bovendien moet je dan ook een regel behind-proxy: true toevoegen. In de documentatie van ntfy staan voorbeeldconfiguraties voor nginx, Apache2 en Caddy.

Met auth-default-access: "deny-all" tot slot heeft standaard niemand toegang tot onderwerpen. Elke toegang moet dus expliciet worden toegestaan.

Account bij ntfy.sh

De ontwikkelaar van ntfy draait een publiek beschikbare ntfy-server op ntfy.sh. De webinterface daarvan is bereikbaar op https://ntfy.sh/app. Die kun je gratis gebruiken, bijvoorbeeld om ntfy uit te proberen, maar dat komt met beperkingen. Zo kun je geen onderwerpen reserveren en is er een maximum van 250 notificaties per dag en 2 MB per bijlage. Verder is er geen enkele vorm van authenticatie. De enige manier van beveiliging ligt dus in het geheimhouden van je onderwerpen. Die beperkingen heb je niet als je ntfy zelf installeert. Maar als je liever niet zelf een installatie onderhoudt, kun je een betaald plan nemen. Daarmee ondersteun je ook de ontwikkeling van het opensource-project. Dat begint met een Supporter-plan van 5 dollar per maand (circa 5 euro), waarmee je drie onderwerpen kunt reserveren en 2.500 notificaties mag sturen met maximum 25 MB per bijlage.

Betaal voor gebruik van de publieke ntfy-server en ondersteuning van het opensource-project.

Docker Compose

Definieer nu de container in het bestand docker-compose.yaml:

services:

  ntfy:

    image: binwiederhier/ntfy

    container_name: ntfy

    command: serve

    restart: always

    environment:

      - TZ=Europe/Amsterdam

    volumes:

      - ./containers/ntfy/cache:/var/cache/ntfy

      - ./containers/ntfy/etc:/etc/ntfy

      - ./containers/ntfy/lib:/var/lib/ntfy

    ports:

      - 80:80

Ga je voor de aanpak met een reverse proxy, dan definieer je in ditzelfde bestand ook een container voor die reverse proxy.

Start daarna de container met:

$ docker-compose up -d

Als alles goed gaat, is de webinterface van ntfy daarna bereikbaar op het ingestelde domein of ip-adres. Bovenaan links zie je een melding Notifications are disabled. Klik op Grant now om notificaties in je webbrowser toe te staan, en bevestig dit daarna in het dialoogvenster dat je webbrowser toont.

Lees ook: Docker op je NAS: zo draai je Plex, Home Assistant en meer

Notificaties testen

Omdat je ntfy zo geconfigureerd hebt dat alle toegang standaard wordt geblokkeerd, kun je nog niets doen in de webinterface. Je dient dus eerst gebruikers aan te maken en die de toelating te geven om op specifieke onderwerpen te publiceren of zich te abonneren. Open daarvoor een shell in de container van ntfy met de opdracht docker exec -ti ntfy /bin/sh. Als je daarna ntfy user list intypt, krijg je te zien dat anonieme, niet geauthenticeerde gebruikers geen enkele permissies hebben. Met de opdracht ntfy user add --role=admin admin voeg je dan een admin-gebruiker met de naam admin toe. Gebruikers met de rol admin kunnen op alle onderwerpen publiceren en zich erop abonneren. Geef de gebruiker een wachtwoord en bevestig.

Klik nu in de webinterface van ntfy links op Settings en dan onder Manage users op Add user. Vul de url van je ntfy-server in, de gebruikersnaam admin en het wachtwoord dat je zojuist hebt ingesteld. Klik dan links op Subscribe to topic. Kies een naam of klik op Generate name om ntfy een willekeurige naam te laten kiezen en abonneer je dan op het onderwerp met Subscribe. Klik dan op Publish notification en vul hetzelfde onderwerp in. Voer ook een titel en een bericht voor je notificatie in en klik op Send. Als alles goed gaat, verschijnt je testbericht nu in een 'conversatie' met de naam van het onderwerp, en wijst je webbrowser je op een notificatie.

Gebruikersrechten

De webapplicatie is leuk voor een test, maar een mobiele app is vaak handiger. De app van Ntfy voor Android en iOS stelt je in staat om op je telefoon je te abonneren op onderwerpen (publiceren is niet mogelijk) en daarvoor notificaties te ontvangen. Als je de Android-app via F-Droid installeert, is dat zonder ondersteuning voor Firebase; de versie op Google Play gebruikt wél de servers van Google. Je maakt voor je app bij voorkeur een gebruiker aan die alle onderwerpen alleen kan lezen. Dat doe je weer in de shell van de container van ntfy met ntfy user add android om de gebruiker android aan te maken (voer een wachtwoord in) en dan ntfy access android "*" read-only voor de leesrechten.

Open daarna de Android-app en tik op de drie stippen rechtsboven. Kies Settings en stel dan Default server in op het domein van je ntfy-server. Tik daarna op Manage users en Add new user en vul de url van je ntfy-server in, de gebruikersnaam android en het bijbehorende wachtwoord. Tik dan op Add user. Keer dan terug naar het hoofdscherm van de app en klik op het plusicoontje rechtsonder. Voer het onderwerp in dat je tijdens de test in stap 5 hebt gebruikt en tik op Subscribe om je erop te abonneren. Vanaf nu zal de app voor elk ontvangen bericht op dit onderwerp een notificatie tonen. Je krijgt zelfs de al verzonden berichten te zien. Overigens toont de app twee waarschuwingen. Voor betrouwbare notificaties volg je de suggesties om batterijoptimalisaties uit te schakelen en naar WebSockets over te schakelen in plaats van een http-stream.

Shellscripts

Nu je hebt getest dat je ntfy-server werkt, is het tijd om je eigen services notificaties te laten uitsturen. Hoe je dat precies configureert, hangt van de service af. Maar je zult altijd eerst een gebruiker met schrijfpermissies voor een specifiek onderwerp moeten aanmaken. Voor een back-upproces dat je op de hoogte moet houden van de status van je back-ups, maak je bijvoorbeeld een gebruiker aan met de opdracht ntfy user add backup in de container van ntfy. Geef die dan schrijfrechten op het onderwerp backup met ntfy access backup backup write-only.

Het publiceren van een bericht op een specifiek onderwerp behelst niet meer dan het sturen van een http POST-aanvraag naar de webserver. Dat kan bijvoorbeeld in een shellscript op je Linux-server met de opdracht curl:

curl -u backup:password -d "Backup successful" ntfy.example.com/backup

Als je in de ntfy-app op je telefoon je op dit onderwerp abonneert, ontvang je deze notificatie nadat het back-upscript is uitgevoerd. Op deze manier is het heel eenvoudig om je eigen shellscripts notificaties te laten verzenden.

Berichten met extra's

Ntfy ondersteunt talloze extra functies om je berichten te laten opvallen of om hun gedrag aan te passen. Je gebruikt deze allemaal door een http-header aan je aanvraag toe te voegen. Zo kun je aan de notificaties van je back-upscript een titel, prioriteit en tags toevoegen. De tags worden als pictogrammen getoond door de mobiele app. Een voorbeeld:

curl -u backup:password -H "Title: Backup failure" -H "Priority: urgent" -H "Tags: warning,skull" -d "Backup unsuccessful" ntfy.example.com/backup

Als de Android-app een bericht met standaardprioriteit ontvangt, doet ze je telefoon kort vibreren en speelt ze een kort geluidje af. Door de prioriteit op urgent te zetten, wordt het standaardnotificatiegeluidje vergezeld van een langer getril van je telefoon, waardoor je onmiddellijk merkt dat dit dringend je aandacht vereist.

Plaatjes en lay-out

Ntfy kan ook plaatjes sturen, bijvoorbeeld een foto van een ip-camera die beweging detecteert, maar niet in combinatie met een tekstbericht. Om een bestand naar ntfy te uploaden met curl in een http PUT-aanvraag gebruik je de optie -T en de bestandsnaam. Met de header Filename voeg je de bestandsnaam toe die de ntfy-app je moet tonen. Dat ziet er dan als volgt uit:

curl -u admin:password -T foto.jpg -H "Filename: beweging.jpg" -H "Title: Beweging voordeur" -H "Tags: boom" ntfy.example.com/beweging

Als je een tekstbericht als Markdown opmaakt, kun je wel plaatjes in een tekst opnemen, maar dan moet je naar het bestand linken. Alleen ntfy's webinterface ondersteunt dit; de mobiele app toont gewoon de Markdown-brontekst. Een Markdown-bericht stuur je door de header Markdown: yes of Content-Type: text/markdown aan je http POST-aanvraag toe te voegen. Ntfy ondersteunt overigens alleen beperkte Markdown-functies, zoals vette en schuine tekst, lijsten, links en afbeeldingen.

Acties

Je ontvangt de notificaties van ntfy in de app in een 'conversatie' per onderwerp. Wanneer je op een notificatie tikt, kopieert dit standaard gewoon de tekst van het bericht naar het klembord. Als je de header Click: URL toevoegt, opent de app die url wanneer je op de notificatie tikt. Zo kun je in een notificatie van je back-upscript bijvoorbeeld een link naar de webinterface van je back-upserver opnemen om het gemelde probleem snel te onderzoeken.

Je kunt ook tot drie 'actieknoppen' definiëren, die dan onderaan een notificatie verschijnen. Door op een van die knoppen te tikken, open je een website of app, activeer je een Android broadcast intent waarop andere apps dan weer kunnen reageren, of zend je een http POST-, PUT- of GET-aanvraag. De manier om dit alles te definiëren is wat omslachtig, maar wordt volledig in de documentatie van ntfy uitgelegd.

Python-code

Curl is natuurlijk niet de enige tool waarmee je notificaties naar je ntfy-server kunt sturen. Sommige tools bieden rechtstreeks ondersteuning voor notificaties via ntfy. Dan hoef je alleen maar het domein van je server, het onderwerp, de gebruikersnaam en het bijbehorende wachtwoord in te vullen. Maar ook in je eigen Python-scripts kun je eenvoudig ondersteuning voor ntfy inbouwen. Dat gaat via het pakket Requests, waarmee je http POST-aanvragen naar de server stuurt. Een eenvoudig voorbeeld ziet er als volgt uit:

import requests

requests.post("http://ntfy.example.com/backup",

    data="Backup unsuccessful",

    headers={

        "Authorization": "Basic Z2VicnVpa2Vyc25hYW06d2FjaHR3b29yZA==",

        "Title": "Backup failure",

        "Priority": "urgent",

        "Tags": "warning,skull"

    })

Met de header Authorization stel je http Basic-authenticatie in. De tekenreeks die na Basic komt, is een Base64-codering van de gebruikersnaam en het wachtwoord met een dubbele punt ertussen. Je creëert die codering op je Linux-systeem met de opdracht echo "Basic $(echo -n 'gebruikersnaam:wachtwoord' | base64)".

En verder

Ntfy biedt een betrouwbare manier om notificaties van allerlei services te centraliseren, terwijl je zelf de volledige controle behoudt. Het programma blinkt uit in flexibiliteit om het overal in te integreren. Als een service bijvoorbeeld geen http POST-aanvragen ondersteunt, kun je ook http GET-aanvragen doen. En als een service je niet de mogelijkheid geeft om de headers aan te passen, laat ntfy je toe om de berichten inclusief headers in JSON-formaat door te sturen. En als een service webhooks ondersteunt maar daarvoor zijn eigen JSON-formaat gebruikt, kan ntfy die met berichtsjablonen omzetten naar leesbare berichten.

Ook via e-mail is ntfy te integreren. Je kunt bijvoorbeeld berichten die op je ntfy-server aankomen automatisch laten doorsturen naar een SMTP-server om ze ook als e-mail te ontvangen. Maar ook de andere richting is voorzien: ntfy kan dan zelf een ingebouwde SMTP-server draaien, handig voor services die alleen maar notificaties via e-mail ondersteunen. Elk onderwerp op de ntfy-server heeft dan een bijbehorend e-mailadres op je domein. De service hoeft dan alleen maar een e-mail naar dat adres te sturen om berichten op dat onderwerp te publiceren op je ntfy-server. Deze en andere geavanceerde functies zijn uitgebreid gedocumenteerd op de website van ntfy.