ntfy hosten op een Managed VPS: pushmeldingen vanaf uw eigen server

ntfy hosten op een Managed VPS betekent dat u pushmeldingen verstuurt met een eenvoudig HTTP-verzoek, PUT of POST, vanaf een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. ntfy is vrije software met een dubbele licentie, Apache 2.0 en GPLv2. Deze gids volgt de officiële documentatie bij versie 2.38.1: de installatie met Docker Compose, het bestand server.yml, gebruikers en toegangsbeheer, toegangstokens, HTTPS, de mobiele apps, e-mail, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 21 november 2026Leestijd: 15 minuten

Alle gidsen

In het kort

  1. ntfy ontvangt een bericht via een HTTP-verzoek PUT of POST naar een topic, en pusht het meteen naar de telefoons, browsers en scripts die op dat topic geabonneerd zijn.
  2. Dankzij de dubbele licentie, Apache 2.0 en GPLv2, draait u ntfy vrij in uw bedrijf; de voorwaarden ervan gelden voor het herverspreiden van de software.
  3. Installeer het met Docker Compose: de image binwiederhier/ntfy, een server.yml met base-url, cache-file en auth-file, en de poort gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.
  4. Standaard kan iedereen elk topic lezen en beschrijven: stel auth-default-access: deny-all in, maak een beheerder aan met ntfy user add en geef daarna elk script een eigen token en beperkte rechten.
  5. Maak een back-up van server.yml en user.db, die de configuratie, gebruikers, rechten en tokens bevatten; werk bij door de tag van de image te wijzigen, nadat u de release-opmerkingen hebt gelezen.

Wat ntfy doet

ntfy, uitgesproken als “notify”, is een HTTP-gebaseerde meldingsdienst volgens het publish-subscribe-principe. De README stelt het voor als een manier om vanuit scripts, vanaf elke computer, meldingen naar uw telefoon of desktop te sturen. Het project draait een openbare instantie, ntfy.sh, en de server kunt u zelf hosten: daarover gaat deze gids.

Terminal, een eerste bericht
curl -d "Backup finished" https://ntfy.example.com/backups

De licenties Apache 2.0 en GPLv2, en het merk

De README van ntfy vermeldt dat het project een dubbele licentie heeft: de Apache License 2.0, in het bestand LICENSE, en de GNU GPL versie 2, in LICENSE.GPLv2. De Docker-image vermeldt ze allebei, Apache-2.0, GPL-2.0.

ntfy op uw server draaien, voor uw bedrijf, uw team of uw klanten, vraagt dus geen licentie om te kopen. Beide teksten leveren de software zonder garantie.

De licentie gaat over de code. De naam is een aparte kwestie: de Apache License 2.0 verleent geen rechten op de merken van de licentiegever, en de gebruiksvoorwaarden van ntfy.sh vermelden dat de naam, het logo en de huisstijl van ntfy merken van ntfy LLC zijn, waarvan het gebruik in verband met een product of dienst haar voorafgaande schriftelijke toestemming vereist. Deze gids noemt ntfy om de software te beschrijven.

Deze publicatie is onafhankelijk van het ntfy-project en van ntfy LLC, en is niet met hen verbonden, noch door hen gesponsord of goedgekeurd.

De middelen waarmee u rekent

De server is één statisch gelinkt binair bestand voor amd64, armv7 en arm64; de Docker-image bestaat ook voor armv6. De documentatie noemt geen cijfers voor geheugen of CPU: voor een server thuis, zegt ze, hoeft u zich over schaal geen zorgen te maken. Ze wijst in plaats daarvan op wat een instantie begrenst:

Vertel ons op een managed VPS over uw gebruik, het aantal geabonneerde apparaten, het berichtenvolume en de bijlagen, dan raden wij u de passende grootte aan.

De installatie met Docker Compose

De documentatie biedt de image binwiederhier/ntfy aan op Docker Hub. Die levert de webapp en de API op poort 80 van de container, en bevat geen bestand server.yml: de configuratie komt in een map die op /etc/ntfy is gekoppeld. Maak op een server waarop Docker is geïnstalleerd een map aan en zet daarin deze compose.yaml, gebaseerd op het voorbeeld uit de documentatie:

compose.yaml
services:
  ntfy:
    image: binwiederhier/ntfy:v2.38.1
    container_name: ntfy
    command:
      - serve
    environment:
      - TZ=UTC
    volumes:
      - ./etc:/etc/ntfy
      - ./lib:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:80"
    healthcheck:
      test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:80/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"]
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 40s
    restart: unless-stopped
    init: true

Daarna het configuratiebestand, in etc/server.yml, met het openbare adres van uw server:

etc/server.yml
base-url: "https://ntfy.example.com"
cache-file: "/var/lib/ntfy/cache.db"
attachment-cache-dir: "/var/lib/ntfy/attachments"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
behind-proxy: true
enable-login: true
Terminal, in de map van compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

De server antwoordt met {"healthy":true,"role":"active"}. Wat elke instelling doet:

Zonder Docker: de repository voor Debian en Ubuntu

Het project publiceert ook een pakketrepository, ondertekend met de sleutel met vingerafdruk 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Op een amd64-server:

Terminal
sudo mkdir -p /etc/apt/keyrings
sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg
sudo apt install apt-transport-https
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main" \
    | sudo tee /etc/apt/sources.list.d/ntfy.list
sudo apt update
sudo apt install ntfy
sudo systemctl enable ntfy
sudo systemctl start ntfy

Het pakket leest /etc/ntfy/server.yml. Het voorbeeldbestand raadt /var/cache/ntfy/cache.db aan voor de cache en /var/lib/ntfy/user.db voor de gebruikers, twee mappen die het pakket aanmaakt. Voeg achter een proxy listen-http: "127.0.0.1:2586" toe.

Gebruikers, toegangsbeheer en tokens

Uit de doos is een ntfy-server open: iedereen kan elk topic lezen en beschrijven, en de naam van het topic dient als wachtwoord. Met auth-file en deny-all komt er zonder inloggegevens niets door. ntfy kent twee rollen: admin, die elk topic leest en beschrijft, en user, die alleen de rechten heeft die u toekent.

Terminal, de eerste beheerder
docker compose exec ntfy ntfy user add --role=admin alice

De opdracht vraagt om het wachtwoord en daarna om de bevestiging ervan. De opdrachten ntfy user, ntfy access en ntfy token schrijven rechtstreeks in de gebruikersdatabase: ze draaien op de server, hier in de container, die het pad naar die database uit server.yml leest.

Eén gebruiker en één token per script

Een toegangstoken geeft op dit moment volledige toegang tot het account van zijn gebruiker, behalve het wijzigen van het wachtwoord en het verwijderen van het account. Maak voor een script een eigen gebruiker aan, beperkt tot zijn topics, en daarna een token voor die gebruiker:

Terminal
docker compose exec ntfy ntfy user add backup-server
docker compose exec ntfy ntfy access backup-server backups write-only
docker compose exec ntfy ntfy token add --label="backups" backup-server

Het script publiceert daarna met zijn token, over HTTPS:

Terminal, op de machine die publiceert
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -d "The nightly backup went fine." \
  https://ntfy.example.com/backups

Een wachtwoord in Basic auth is alleen in base64 gecodeerd, niet versleuteld: de documentatie vraagt HTTPS voor elke zelf gehoste server. Daarover gaat de volgende sectie.

HTTPS: de reverse proxy

ntfy kan zelf HTTPS leveren, maar achter een proxy raadt de documentatie aan de TLS-terminatie aan de proxy over te laten. Twee punten wegen zwaarder dan al het andere:

Met Caddy

De documentatie merkt op dat Caddy met reverse_proxy zowel HTTP als WebSockets afhandelt, zonder extra instellingen. Het haalt zelf het certificaat van Let’s Encrypt op:

Caddyfile
ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}

Met Nginx

Dit blok volgt de configuratie uit de documentatie, dicht bij die van ntfy.sh: buffering uitgeschakeld voor de streams, time-outs van 3 minuten en geen groottelimiet voor de body van verzoeken, die ntfy zelf begrenst. Het luistert op poort 80, zodat Certbot HTTPS kan instellen:

/etc/nginx/sites-available/ntfy
server {
    listen 80;
    listen [::]:80;
    server_name ntfy.example.com;

    location / {
        proxy_pass http://127.0.0.1:2586;
        proxy_http_version 1.1;

        proxy_buffering off;
        proxy_request_buffering off;
        proxy_redirect off;

        proxy_set_header Host $http_host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_connect_timeout 3m;
        proxy_send_timeout 3m;
        proxy_read_timeout 3m;

        client_max_body_size 0;
    }
}
Terminal
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com

Zodra HTTP doorverwijst naar HTTPS, publiceert u in uw scripts naar https://-adressen. Voor duizenden abonnees verhoogt de documentatie worker_connections in nginx.conf en de LimitNOFILE van de Nginx-dienst tot het dubbele van het beoogde aantal verbindingen.

De apps voor Android, iOS en het web

De ntfy-apps voegen topics van uw server toe zoals ze dat doen voor ntfy.sh: voer het adres van uw server in wanneer u het topic toevoegt, en voor een beveiligd topic de gebruikersnaam en het wachtwoord van een gebruiker die er toegang toe heeft. De webapp wordt geleverd op het adres van de server zelf.

Directe meldingen op iOS

Voeg één regel toe aan server.yml en herstart daarna de container:

etc/server.yml
upstream-base-url: "https://ntfy.sh"

Voor elk bericht publiceert uw server dan een poll-verzoek naar ntfy.sh, dat alleen het ID van het bericht en de SHA-256-hash van de URL van het topic bevat. ntfy.sh geeft het via de meldingsdienst van Apple door aan het apparaat, waarna de app het bericht van uw server ophaalt. De tekst die via ntfy.sh gaat, is altijd dezelfde, “New message”, wat uw bericht ook zegt. Zonder deze instelling komen meldingen toch aan, met een vertraging die afhankelijk van de toestand van de telefoon tot enkele uren kan oplopen. upstream-access-token voegt een token toe als u de snelheidslimieten van ntfy.sh overschrijdt.

Snelheidslimieten en bijlagen

ntfy begrenst elke bezoeker, herkend aan zijn IP-adres, en bij IPv6 aan zijn /64-subnet. Deze limieten beschermen de server tegen misbruik; bij normaal gebruik zou u ze volgens de documentatie niet moeten tegenkomen. Daarboven antwoordt de server met 429 Too Many Requests. De standaardwaarden:

InstellingStandaardWat het begrenst
visitor-request-limit-burst60De verzoeken van een bezoeker in één piek
visitor-request-limit-replenish5sHet aanvultempo: één verzoek per 5 seconden
visitor-subscription-limit30Open verbindingen per bezoeker
visitor-message-daily-limitGeenBerichten per dag, verder geregeld door de verzoeklimiet
visitor-email-limit-burst16E-mails in één piek, daarna één per uur
visitor-attachment-total-size-limit100MOpslag voor bijlagen per bezoeker
visitor-attachment-daily-bandwidth-limit500MVerkeer voor bijlagen per bezoeker per dag
global-topic-limit15.000Het totale aantal topics van de server
message-size-limit4KDe grootte van een bericht; daarboven wordt het een bijlage

Meldingen per e-mail

ntfy kan een bericht per e-mail doorsturen wanneer het publicatieverzoek de header Email, of X-Email, met een adres bevat. Daarvoor gaat het via een uitgaande SMTP-server, met STARTTLS en authenticatie via PLAIN of LOGIN: dat is poort 587. Vanaf een Simafri-VPS loopt het verzenden via een geauthenticeerde SMTP-relay op diezelfde poort 587: vul hier het adres in van een e-mailaccount dat u al hebt, of dat van uw verzenddienst.

etc/server.yml
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
Terminal
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Email: alice@example.com" \
  -d "The file server disk is over 90% full." \
  https://ntfy.example.com/alerts

Back-ups

Met SQLite bewaart ntfy elk soort gegevens in een eigen bestand. In de installatie van deze gids staat alles in de mappen etc en lib, naast de compose.yaml:

OnderdeelWat het bevatBack-up maken
etc/server.ymlDe configuratie, inclusief de SMTP-geheimen en de Web Push-sleutelsJa
lib/user.dbGebruikers, regels voor toegangsbeheer, tokens en dagtellersJa
lib/cache.dbDe berichten van de laatste 12 uur, standaardNuttig, de levensduur is kort
lib/attachments/De bijlagen van de laatste 3 uur, standaardNuttig, de levensduur is kort
Bestand web-push-fileDe Web Push-abonnementen van browsers, als u dit hebt ingeschakeldJa

Stop voor een consistente kopie van de SQLite-bestanden de dienst terwijl het archief wordt gemaakt:

Terminal, in de map van compose.yaml
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start

Plan deze kopie in op een rustig uur, en stuur haar buiten de server. Staan deze archieven op de schijf van de server, dan vallen ze ook onder de nachtelijke back-ups. Zet om terug te zetten de mappen weer op hun plaats en voer daarna docker compose up -d uit.

Raakt u user.db kwijt zonder kopie, dan worden de gebruikers en tokens die in server.yml zijn gedeclareerd via auth-users en auth-tokens bij de start opnieuw aangemaakt; die u op de opdrachtregel hebt aangemaakt, maakt u opnieuw aan.

Updates

Wijzig met Docker de tag van de image in compose.yaml, bijvoorbeeld van v2.38.1 naar de volgende versie, en daarna:

Terminal, in de map van compose.yaml
docker compose pull
docker compose up -d

De mappen etc en lib blijven op hun plaats, en ntfy migreert zijn databases zelf bij de start. Met het Debian-pakket doen sudo apt update en daarna sudo apt upgrade hetzelfde.

De opmerkingen bij elke versie, op de pagina “Releases” van de documentatie, bundelen onder “Upgrade notes” wat er verandert voor een bestaande instantie, zoals in 2.36.0 een configuratie die voortaan volledig wordt gecontroleerd bij de start, of dagtellers die op nul worden gezet. Lees ze vóór het bijwerken, en kopieer beide mappen vlak daarvoor. Versie 2.38.1 is een beveiligingsrelease die het project sterk aanbeveelt: ze maakt de templating van berichten beter bestand tegen denial-of-service-aanvallen en voorkomt dat trage uploads van bijlagen naar S3 en web-push-endpoints die niet meer reageren geheugen en verbindingen bezet houden. Ze volgt op 2.38.0, die de snelheidslimieten tussen de nodes van een cluster deelt en gebouwd is met Go 1.27.4.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; ntfy blijft uw software, met zijn instellingen en gegevens.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenHet lezen van de logboeken van uw instantie
ntfyProactief toezicht: fouten, vertragingen, open verbindingen en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De toegangDe server die ntfy draagt, bewaakt en geback-uptDe gebruikers, de rechten op de topics en de tokens van uw scripts
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe eigen kopieën van ntfy, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

ntfy, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw ntfy-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is ntfy gratis voor een bedrijf?

Ja. ntfy heeft een dubbele licentie, Apache 2.0 en GPLv2: u mag het in een bedrijf draaien zonder een licentie te kopen. De voorwaarden ervan gelden voor het herverspreiden van de software. Wat overblijft, zijn de kosten van de server waarop het draait.

Hoe installeer ik ntfy met Docker Compose?

Maak een compose.yaml met de image binwiederhier/ntfy, de opdracht serve, een map gekoppeld op /etc/ntfy voor server.yml, een andere op /var/lib/ntfy voor de databases, en poort 80 van de container gepubliceerd op 127.0.0.1:2586. Voer docker compose up -d uit en zet daarna een reverse proxy met HTTPS voor die poort.

Hoe maak ik een ntfy-server privé?

Stel in server.yml auth-file en auth-default-access: deny-all in. Maak daarna een beheerder aan met ntfy user add --role=admin, beperkte gebruikers met ntfy user add, en hun rechten op topics met ntfy access.

Hoe publiceer ik vanuit een script met een token naar ntfy?

Maak met ntfy token add een token voor een gebruiker die voor het script is bestemd en tot zijn topics is beperkt, en publiceer daarna met curl en de header Authorization: Bearer gevolgd door het token, over HTTPS. Een token geeft toegang tot het hele account van zijn gebruiker.

Waarom behind-proxy instellen in ntfy?

Achter een reverse proxy komt elk verzoek van het adres van de proxy. Met behind-proxy: true leest ntfy de header X-Forwarded-For om elke bezoeker te herkennen; zonder deze instelling delen ze allemaal dezelfde snelheidslimieten.

Komen ntfy-meldingen meteen aan op een iPhone?

Ja, met upstream-base-url: "https://ntfy.sh" in server.yml. Uw server laat dan via ntfy.sh een signaal doorgeven dat alleen het ID van het bericht bevat, en de app haalt het bericht van uw server op. Zonder deze instelling kan de bezorging enkele uren duren.

Hoe maak ik een back-up van ntfy?

Maak een back-up van server.yml en user.db, die de configuratie, gebruikers, rechten en tokens bevatten, plus het Web Push-bestand als dat is ingeschakeld. De berichtencache en de bijlagen hebben een korte levensduur. Stop de dienst tijdens het kopiëren, voor consistente SQLite-bestanden.

Dekt een managed VPS ook ntfy?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Neem contact op