Att hosta ntfy på en Managed VPS innebär att du skickar pushnotiser med en enkel HTTP-begäran, PUT eller POST, från en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. ntfy är fri programvara med dubbel licens, Apache 2.0 och GPLv2. Den här guiden följer den officiella dokumentationen i version 2.38.1: installation med Docker Compose, filen server.yml, användare och åtkomstkontroll, åtkomsttoken, HTTPS, mobilapparna, e-post, säkerhetskopior och uppdateringar.
Av Simon Vasconcelos Lee
Publicerad den 21 november 2026Lästid: 15 minuter
binwiederhier/ntfy, en server.yml med base-url, cache-file och auth-file, och porten publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.auth-default-access: deny-all, skapa en administratör med ntfy user add och ge sedan varje skript en egen token och begränsade behörigheter.server.yml och user.db, som innehåller konfigurationen, användarna, behörigheterna och token; uppdatera genom att byta avbildens tagg, efter att ha läst versionsanteckningarna.ntfy, som uttalas ”notify”, är en HTTP-baserad notistjänst enligt publish-subscribe-principen. Dess README presenterar den som ett sätt att skicka notiser till din telefon eller dator från skript, från vilken dator som helst. Projektet driver en offentlig instans, ntfy.sh, och servern går att hosta själv: det är vad den här guiden handlar om.
curl, ett skript, ett schemalagt jobb eller en annan applikation. Ett meddelande kan ha en titel, en prioritet från 1 till 5, taggar och emojier, en bilaga, åtgärdsknappar eller en fördröjd leveranstid.ntfy eller API:t, via WebSocket eller en HTTP-ström som hålls öppen.curl -d "Backup finished" https://ntfy.example.com/backups
ntfys README anger att projektet har dubbel licens: Apache License 2.0, i filen LICENSE, och GNU GPL version 2, i LICENSE.GPLv2. Docker-avbilden anger båda, Apache-2.0, GPL-2.0.
Att köra ntfy på din server, för ditt företag, ditt team eller dina kunder, kräver alltså ingen licens att köpa. Båda texterna tillhandahåller programvaran utan garanti.
Licensen gäller koden. Namnet är en annan fråga: Apache License 2.0 ger inga rättigheter till licensgivarens varumärken, och användarvillkoren för ntfy.sh anger att namnet, logotypen och den grafiska profilen för ntfy är varumärken som tillhör ntfy LLC, och att användning av dem i samband med en produkt eller tjänst kräver dess skriftliga förhandsgodkännande. Den här guiden nämner ntfy för att beskriva programvaran.
Den här publikationen är oberoende av ntfy-projektet och ntfy LLC, och är varken knuten till, sponsrad eller godkänd av dem.
Servern är en enda statiskt länkad binärfil för amd64, armv7 och arm64; Docker-avbilden finns också för armv6. Dokumentationen anger inga siffror för minne eller processor: för en server hemma, säger den, är skalan inget att oroa sig för. I stället pekar den på det som sätter gränsen för en instans:
nofile, tillåter. Paketets systemd-tjänst sätter den till 10 000.På en Managed VPS berättar du om din användning, antalet prenumererande enheter, mängden meddelanden och bilagorna, så rekommenderar vi lämplig storlek.
Dokumentationen erbjuder avbilden binwiederhier/ntfy på Docker Hub. Den levererar webbappen och API:t på containerns port 80 och innehåller ingen fil server.yml: konfigurationen läggs i en mapp som monteras på /etc/ntfy. Skapa en mapp på en server med Docker installerat och lägg denna compose.yaml i den, baserad på dokumentationens exempel:
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
Sedan konfigurationsfilen, i etc/server.yml, med serverns offentliga adress:
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
Servern svarar {"healthy":true,"role":"active"}. Vad varje inställning gör:
127.0.0.1:2586: dokumentationens Docker-exempel publicerar port 80 på alla adresser, och dess exempel med omvänd proxy vidarebefordrar till 127.0.0.1:2586. Publicerad på det här sättet går porten bara att nå från själva servern, och API:t nås enbart via den omvända proxyn, över HTTPS.base-url: tjänstens offentliga adress. Exempelfilen server.yml kräver den för bilagor, e-postutskick och iOS-notiser från en självhostad server.cache-file: utan den stannar meddelandena 12 timmar i minnet och går förlorade vid omstart. Den här cachen låter telefoner med ostadig anslutning hämta de meddelanden de har missat.attachment-cache-dir: aktiverar bilagor. ntfy tar full kontroll över den här mappen, så reservera den för det ändamålet.auth-file och auth-default-access: deny-all: databasen med användare och behörigheter, som skapas vid första starten, och anonym åtkomst som nekas som standard. Det är den inställning dokumentationen rekommenderar för en privat instans.behind-proxy: utan den delar alla besökare bakom en proxy proxyns IP-adress och samma hastighetsgränser.enable-login: gör det möjligt att logga in i webbappen. Fri registrering förblir stängd, eftersom enable-signup som standard är false.v2.38.1 låser versionen; latest följer den senaste utgåvan. Dokumentationen erbjuder också user: UID:GID för ett konto utan root-behörighet: filerna i etc och lib tillhör då det kontot.Projektet publicerar också ett paketförråd, signerat med nyckeln med fingeravtrycket 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. På en 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
Paketet läser /etc/ntfy/server.yml. Exempelfilen rekommenderar /var/cache/ntfy/cache.db för cachen och /var/lib/ntfy/user.db för användarna, två mappar som paketet skapar. Bakom en proxy lägger du till listen-http: "127.0.0.1:2586".
Från början är en ntfy-server öppen: alla kan läsa och skriva i alla ämnen, och ämnets namn fungerar som lösenord. Med auth-file och deny-all släpps ingenting igenom utan inloggningsuppgifter. ntfy har två roller: admin, som läser och skriver i alla ämnen, och user, som bara har de behörigheter du ger den.
docker compose exec ntfy ntfy user add --role=admin alice
Kommandot frågar efter lösenordet och sedan efter en bekräftelse. Kommandona ntfy user, ntfy access och ntfy token skriver direkt i användardatabasen: de körs på servern, här i containern, som läser sökvägen till databasen från server.yml.
En åtkomsttoken ger i dagsläget full åtkomst till användarens konto, utom att byta lösenord och radera kontot. För ett skript skapar du en egen användare, begränsad till sina ämnen, och sedan en token åt den:
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 eller deny, på ett visst ämne eller på ett mönster som alerts-*, det enda jokertecken som stöds.everyone, eller *. För UnifiedPush på en privat instans öppnar dokumentationen de ämnen som börjar med up enbart för skrivning: ntfy access '*' 'up*' write-only.tk_, kan löpa ut med --expires=30d, och varje användare kan ha upp till 60 av dem. ntfy token list visar dem, ntfy token remove raderar en.auth-users, auth-access och auth-tokens samma objekt från server.yml, vid varje start. En användare som tas bort från listan raderas ur databasen vid nästa omstart.Skriptet publicerar sedan med sin token, över 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
Ett lösenord i Basic auth är bara base64-kodat, inte krypterat: dokumentationen kräver HTTPS på varje självhostad server. Det är vad nästa avsnitt handlar om.
ntfy kan själv leverera HTTPS, men bakom en proxy rekommenderar dokumentationen att lämna TLS-termineringen åt proxyn. Två punkter väger tyngre än allt annat:
Upgrade och Connection och låter de här långa anslutningarna leva. ntfy skickar som standard ett keepalive-meddelande var 45:e sekund, keepalive-interval, så att ingen mellanhand stänger dem på grund av inaktivitet.behind-proxy: true läser ntfy huvudet X-Forwarded-For och behåller adressen längst till höger, den som din proxy lägger till. Hastighetsgränserna gäller för den adressen.Dokumentationen påpekar att Caddy hanterar både HTTP och WebSockets med reverse_proxy, utan extra inställningar. Den hämtar själv certifikatet från Let’s Encrypt:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Det här blocket följer dokumentationens konfiguration, nära den som ntfy.sh kör: buffring avstängd för strömmarna, tidsgränser på 3 minuter och ingen storleksgräns för begärandenas innehåll, som ntfy själv begränsar. Det lyssnar på port 80, så att Certbot kan sätta upp HTTPS:
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
När HTTP omdirigerar till HTTPS publicerar du till https://-adresser i dina skript. För tusentals prenumeranter höjer dokumentationen worker_connections i nginx.conf och Nginx-tjänstens LimitNOFILE till det dubbla antalet anslutningar du siktar på.
ntfy-apparna lägger till ämnen från din server precis som från ntfy.sh: ange serverns adress när du lägger till ämnet, och för ett skyddat ämne användarnamn och lösenord för en användare som har åtkomst till det. Webbappen levereras på serverns egen adress.
ntfy webpush keys och ett giltigt HTTPS-certifikat.Lägg till en rad i server.yml och starta sedan om containern:
upstream-base-url: "https://ntfy.sh"
För varje meddelande publicerar din server då en poll-begäran till ntfy.sh, som bara innehåller meddelandets ID och SHA-256-hashen av ämnets URL. ntfy.sh skickar den vidare till enheten via Apples notistjänst, och sedan hämtar appen meddelandet från din server. Texten som går via ntfy.sh är alltid densamma, ”New message”, vad ditt meddelande än säger. Utan den här inställningen kommer notiserna ändå fram, med en fördröjning som kan uppgå till flera timmar beroende på telefonens tillstånd. upstream-access-token lägger till en token om du överskrider hastighetsgränserna hos ntfy.sh.
ntfy begränsar varje besökare, identifierad genom sin IP-adress och för IPv6 genom sitt /64-subnät. Gränserna skyddar servern mot missbruk; vid normal användning bör du enligt dokumentationen inte stöta på dem. Över dem svarar servern 429 Too Many Requests. Standardvärdena:
| Inställning | Standard | Vad den begränsar |
|---|---|---|
visitor-request-limit-burst | 60 | En besökares begäranden i en skur |
visitor-request-limit-replenish | 5s | Påfyllnadstakten: en begäran var 5:e sekund |
visitor-subscription-limit | 30 | Öppna anslutningar per besökare |
visitor-message-daily-limit | Ingen | Meddelanden per dag, annars styrda av gränsen för begäranden |
visitor-email-limit-burst | 16 | E-postmeddelanden i en skur, sedan ett per timme |
visitor-attachment-total-size-limit | 100M | Lagring av bilagor per besökare |
visitor-attachment-daily-bandwidth-limit | 500M | Trafik för bilagor per besökare och dag |
global-topic-limit | 15 000 | Serverns totala antal ämnen |
message-size-limit | 4K | Ett meddelandes storlek; över den blir det en bilaga |
visitor-request-limit-exempt-hosts, en lista med IP-adresser eller värdnamn.ntfy tier, ger vissa konton högre gränser.attachment-file-size-limit, som standard 15M, begränsar varje fil, attachment-total-size-limit, 5G, hela lagringen, och attachment-expiry-duration, 3h, deras livslängd. En bilaga lever högst lika länge som sitt meddelande: för att behålla bilagor längre höjer du också cache-duration.ntfy kan vidarebefordra ett meddelande via e-post när publiceringsbegäran har huvudet Email, eller X-Email, med en adress. Då går det via en utgående SMTP-server, med STARTTLS och autentisering via PLAIN eller LOGIN: det är port 587. Från en VPS hos Simafri går utskicken via ett autentiserat SMTP-relä på samma port 587: ange här adressen till ett e-postkonto du redan har, eller till din utskickstjänst.
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 och smtp-sender-from krävs så snart smtp-sender-addr är inställt: utan dem vägrar servern att starta.smtp-sender-verify: true begränsar utskicken till de adresser som varje användare har verifierat i sitt konto, och stänger dem för anonyma användare.server.yml: gör filen läsbar enbart för dess ägare, med chmod 600.Med SQLite håller ntfy varje typ av data i en egen fil. I den här guidens installation ligger allt i mapparna etc och lib, bredvid compose.yaml:
| Del | Vad den innehåller | Säkerhetskopiera |
|---|---|---|
etc/server.yml | Konfigurationen, inklusive SMTP-hemligheter och Web Push-nycklar | Ja |
lib/user.db | Användare, regler för åtkomstkontroll, token och dagliga räknare | Ja |
lib/cache.db | Meddelanden från de senaste 12 timmarna, som standard | Användbart, livslängden är kort |
lib/attachments/ | Bilagor från de senaste 3 timmarna, som standard | Användbart, livslängden är kort |
Filen web-push-file | Webbläsarnas Web Push-prenumerationer, om du har aktiverat det | Ja |
För en konsekvent kopia av SQLite-filerna stoppar du tjänsten medan arkivet skapas:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Schemalägg den här kopian till en lugn timme, och skicka den utanför servern. Lagda på dess disk ingår de här arkiven också i dess nattliga säkerhetskopior. För att återställa lägger du tillbaka mapparna på plats och kör sedan docker compose up -d.
Förlorar du user.db utan kopia återskapas de användare och token som deklarerats i server.yml via auth-users och auth-tokens vid start; de som skapats på kommandoraden skapar du på nytt.
Med Docker byter du avbildens tagg i compose.yaml, till exempel från v2.38.1 till nästa version, och sedan:
docker compose pull
docker compose up -d
Mapparna etc och lib ligger kvar, och ntfy migrerar själv sina databaser vid start. Med Debian-paketet gör sudo apt update och sedan sudo apt upgrade samma sak.
Anteckningarna för varje version, på dokumentationens sida ”Releases”, samlar under ”Upgrade notes” det som ändras för en befintlig instans, som i 2.36.0 en konfiguration som numera kontrolleras fullständigt vid start, eller dagliga räknare som nollställs. Läs dem före uppdateringen, och kopiera båda mapparna precis innan. Version 2.38.1 är en säkerhetsversion som projektet starkt rekommenderar: den gör mallarna för meddelanden tåligare mot överbelastningsattacker och hindrar långsamma uppladdningar av bilagor till S3 och web push-slutpunkter som inte svarar från att binda upp minne och anslutningar. Den följer på 2.38.0, som delar hastighetsgränserna mellan noderna i ett kluster och är byggd med Go 1.27.4.
Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; ntfy förblir din programvara, med sina inställningar och sina data.
| Område | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans loggar |
| ntfy | Proaktiv uppföljning: fel, långsamma svarstider, öppna anslutningar och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Åtkomsten | Servern som bär den, övervakad och säkerhetskopierad | Användarna, behörigheterna på ämnena och dina skripts token |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | ntfys egna kopior och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten för bytet |
Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.
Med en Managed VPS från Simafri håller våra team servern för din ntfy-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.
Ja. ntfy har dubbel licens, Apache 2.0 och GPLv2: du kan köra det i ditt företag utan att köpa någon licens. Deras villkor gäller vidaredistribution av programvaran. Kvar blir kostnaden för servern som kör det.
Skapa en compose.yaml med avbilden binwiederhier/ntfy, kommandot serve, en mapp monterad på /etc/ntfy för server.yml, en annan på /var/lib/ntfy för databaserna, och containerns port 80 publicerad på 127.0.0.1:2586. Kör docker compose up -d och sätt sedan en omvänd proxy med HTTPS framför den porten.
I server.yml ställer du in auth-file och auth-default-access: deny-all. Skapa sedan en administratör med ntfy user add --role=admin, begränsade användare med ntfy user add och deras behörigheter på ämnen med ntfy access.
Skapa en token med ntfy token add för en användare som är avsedd för skriptet och begränsad till dess ämnen, och publicera sedan med curl och huvudet Authorization: Bearer följt av token, över HTTPS. En token ger åtkomst till hela användarens konto.
Bakom en omvänd proxy kommer varje begäran från proxyns adress. Med behind-proxy: true läser ntfy huvudet X-Forwarded-For för att identifiera varje besökare; utan den delar alla samma hastighetsgränser.
Ja, med upstream-base-url: "https://ntfy.sh" i server.yml. Din server låter då en signal gå via ntfy.sh som bara innehåller meddelandets ID, och appen hämtar meddelandet från din server. Utan den här inställningen kan leveransen ta flera timmar.
Säkerhetskopiera server.yml och user.db, som innehåller konfigurationen, användarna, behörigheterna och token, plus Web Push-filen om den är aktiverad. Meddelandecachen och bilagorna har kort livslängd. Stoppa tjänsten medan du kopierar, för konsekventa SQLite-filer.
En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.