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.
Door Simon Vasconcelos Lee
Gepubliceerd op 21 november 2026Leestijd: 15 minuten
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.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.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.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.
curl, een script, een geplande taak of een andere applicatie. Een bericht kan een titel, een prioriteit van 1 tot 5, tags en emoji, een bijlage, actieknoppen of een uitgesteld bezorgmoment meekrijgen.ntfy of de API, via WebSocket of een HTTP-stream die open blijft.curl -d "Backup finished" https://ntfy.example.com/backups
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 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:
nofile, toelaat. De systemd-dienst van het pakket zet die op 10.000.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 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:
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:
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
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:
127.0.0.1:2586: de Docker-voorbeelden uit de documentatie publiceren poort 80 op alle adressen, en de voorbeelden voor de reverse proxy sturen door naar 127.0.0.1:2586. Zo gepubliceerd is de poort alleen vanaf de server zelf bereikbaar, en is de API uitsluitend via de reverse proxy bereikbaar, over HTTPS.base-url: het openbare adres van de dienst. Het voorbeeldbestand server.yml vereist het voor bijlagen, het versturen van e-mail en iOS-meldingen vanaf een zelf gehoste server.cache-file: zonder deze instelling blijven berichten 12 uur in het geheugen en gaan ze verloren bij een herstart. Met deze cache halen telefoons met een wankele verbinding de berichten op die ze gemist hebben.attachment-cache-dir: schakelt bijlagen in. ntfy neemt deze map volledig onder zijn beheer, dus reserveer haar voor dit doel.auth-file en auth-default-access: deny-all: de database met gebruikers en rechten, aangemaakt bij de eerste start, en anonieme toegang standaard geweigerd. Dit is de instelling die de documentatie aanraadt voor een privé-instantie.behind-proxy: zonder deze instelling delen achter een proxy alle bezoekers het IP-adres van de proxy en dezelfde snelheidslimieten.enable-login: maakt aanmelden in de webapp mogelijk. Vrije registratie blijft dicht, omdat enable-signup standaard op false staat.v2.38.1 legt de versie vast; latest volgt de nieuwste release. De documentatie biedt ook user: UID:GID voor een account zonder rootrechten: de bestanden in etc en lib zijn dan van dat account.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:
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.
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.
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.
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:
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
read-write, read-only, write-only of deny, op een bepaald topic of op een patroon zoals alerts-*, de enige ondersteunde wildcard.everyone, of *. Voor UnifiedPush op een privé-instantie zet de documentatie de topics die met up beginnen alleen open voor schrijven: ntfy access '*' 'up*' write-only.tk_, kunnen verlopen met --expires=30d, en elke gebruiker kan er tot 60 houden. ntfy token list toont ze, ntfy token remove verwijdert er een.auth-users, auth-access en auth-tokens dezelfde objecten aan vanuit server.yml, bij elke start. Een gebruiker die uit die lijst wordt gehaald, wordt bij de volgende herstart uit de database verwijderd.Het script publiceert daarna met zijn token, over HTTPS:
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.
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:
Upgrade en Connection door en laat deze lange verbindingen bestaan. ntfy stuurt standaard elke 45 seconden een keepalive-bericht, keepalive-interval, zodat geen enkele tussenschakel ze wegens inactiviteit sluit.behind-proxy: true leest ntfy de header X-Forwarded-For en houdt het meest rechtse adres aan, het adres dat uw proxy toevoegt. De snelheidslimieten gelden voor dat adres.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:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
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:
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;
}
}
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 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.
ntfy webpush keys genereert, en een geldig HTTPS-certificaat.Voeg één regel toe aan server.yml en herstart daarna de container:
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.
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:
| Instelling | Standaard | Wat het begrenst |
|---|---|---|
visitor-request-limit-burst | 60 | De verzoeken van een bezoeker in één piek |
visitor-request-limit-replenish | 5s | Het aanvultempo: één verzoek per 5 seconden |
visitor-subscription-limit | 30 | Open verbindingen per bezoeker |
visitor-message-daily-limit | Geen | Berichten per dag, verder geregeld door de verzoeklimiet |
visitor-email-limit-burst | 16 | E-mails in één piek, daarna één per uur |
visitor-attachment-total-size-limit | 100M | Opslag voor bijlagen per bezoeker |
visitor-attachment-daily-bandwidth-limit | 500M | Verkeer voor bijlagen per bezoeker per dag |
global-topic-limit | 15.000 | Het totale aantal topics van de server |
message-size-limit | 4K | De grootte van een bericht; daarboven wordt het een bijlage |
visitor-request-limit-exempt-hosts, een lijst van IP-adressen of hostnamen.ntfy tier, geven sommige accounts hogere limieten.attachment-file-size-limit, standaard 15M, begrenst elk bestand, attachment-total-size-limit, 5G, de hele opslag, en attachment-expiry-duration, 3h, hun levensduur. Een bijlage leeft hooguit zo lang als haar bericht: verhoog om bijlagen langer te bewaren ook cache-duration.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.
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
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
base-url en smtp-sender-from zijn verplicht zodra smtp-sender-addr is ingesteld: zonder deze twee weigert de server te starten.smtp-sender-verify: true beperkt het verzenden tot de adressen die elke gebruiker in zijn account heeft geverifieerd, en sluit het af voor anonieme gebruikers.server.yml: maak dat bestand alleen leesbaar voor de eigenaar, met chmod 600.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:
| Onderdeel | Wat het bevat | Back-up maken |
|---|---|---|
etc/server.yml | De configuratie, inclusief de SMTP-geheimen en de Web Push-sleutels | Ja |
lib/user.db | Gebruikers, regels voor toegangsbeheer, tokens en dagtellers | Ja |
lib/cache.db | De berichten van de laatste 12 uur, standaard | Nuttig, de levensduur is kort |
lib/attachments/ | De bijlagen van de laatste 3 uur, standaard | Nuttig, de levensduur is kort |
Bestand web-push-file | De Web Push-abonnementen van browsers, als u dit hebt ingeschakeld | Ja |
Stop voor een consistente kopie van de SQLite-bestanden de dienst terwijl het archief wordt gemaakt:
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.
Wijzig met Docker de tag van de image in compose.yaml, bijvoorbeeld van v2.38.1 naar de volgende versie, en daarna:
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.
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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie |
| ntfy | Proactief toezicht: fouten, vertragingen, open verbindingen en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De toegang | De server die ntfy draagt, bewaakt en geback-upt | De gebruikers, de rechten op de topics en de tokens van uw scripts |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen kopieën van ntfy, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.