Hosta ntfy på en Managed VPS: pushnotiser från din egen server

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.

Simon Vasconcelos Lee Av Publicerad den 21 november 2026Lästid: 15 minuter

Alla guider

I korthet

  1. ntfy tar emot ett meddelande via en HTTP-begäran PUT eller POST till ett ämne och skickar det direkt vidare till de telefoner, webbläsare och skript som prenumererar på ämnet.
  2. Den dubbla licensen, Apache 2.0 och GPLv2, låter dig fritt köra ntfy i ditt företag; dess villkor gäller vidaredistribution av programvaran.
  3. Installera med Docker Compose: avbilden 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.
  4. Som standard kan alla läsa och skriva i alla ämnen: ställ in 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.
  5. Säkerhetskopiera 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.

Vad ntfy gör

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.

Terminal, ett första meddelande
curl -d "Backup finished" https://ntfy.example.com/backups

Licenserna Apache 2.0 och GPLv2, och varumärket

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.

Resurserna att planera för

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:

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.

Installation med Docker Compose

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:

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

Sedan konfigurationsfilen, i etc/server.yml, med serverns offentliga adress:

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, i mappen med compose.yaml
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:

Utan Docker: förrådet för Debian och Ubuntu

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:

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

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".

Användare, åtkomstkontroll och token

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.

Terminal, den första administratören
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 användare och en token per skript

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:

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

Skriptet publicerar sedan med sin token, över HTTPS:

Terminal, på maskinen som publicerar
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.

HTTPS: den omvända proxyn

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:

Med Caddy

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:

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

Med Nginx

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:

/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

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å.

Apparna för Android, iOS och webben

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.

Omedelbara notiser på iOS

Lägg till en rad i server.yml och starta sedan om containern:

etc/server.yml
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.

Hastighetsgränser och bilagor

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ällningStandardVad den begränsar
visitor-request-limit-burst60En besökares begäranden i en skur
visitor-request-limit-replenish5sPåfyllnadstakten: en begäran var 5:e sekund
visitor-subscription-limit30Öppna anslutningar per besökare
visitor-message-daily-limitIngenMeddelanden per dag, annars styrda av gränsen för begäranden
visitor-email-limit-burst16E-postmeddelanden i en skur, sedan ett per timme
visitor-attachment-total-size-limit100MLagring av bilagor per besökare
visitor-attachment-daily-bandwidth-limit500MTrafik för bilagor per besökare och dag
global-topic-limit15 000Serverns totala antal ämnen
message-size-limit4KEtt meddelandes storlek; över den blir det en bilaga

Notiser via e-post

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.

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

Säkerhetskopior

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:

DelVad den innehållerSäkerhetskopiera
etc/server.ymlKonfigurationen, inklusive SMTP-hemligheter och Web Push-nycklarJa
lib/user.dbAnvändare, regler för åtkomstkontroll, token och dagliga räknareJa
lib/cache.dbMeddelanden från de senaste 12 timmarna, som standardAnvändbart, livslängden är kort
lib/attachments/Bilagor från de senaste 3 timmarna, som standardAnvändbart, livslängden är kort
Filen web-push-fileWebbläsarnas Web Push-prenumerationer, om du har aktiverat detJa

För en konsekvent kopia av SQLite-filerna stoppar du tjänsten medan arkivet skapas:

Terminal, i mappen med compose.yaml
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.

Uppdateringar

Med Docker byter du avbildens tagg i compose.yaml, till exempel från v2.38.1 till nästa version, och sedan:

Terminal, i mappen med compose.yaml
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.

Vem gör vad på en Managed VPS

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ådeVåra teamDu
ServernUppdateringar av system och säkerhet, ingrepp på servern inräknadeTidpunkten som passar din verksamhet
ÖvervakningenServern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtalLäsningen av din instans loggar
ntfyProaktiv uppföljning: fel, långsamma svarstider, öppna anslutningar och diskutrymme upptäcks, med rekommenderad rättelseInstallationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent
ÅtkomstenServern som bär den, övervakad och säkerhetskopieradAnvändarna, behörigheterna på ämnena och dina skripts token
SäkerhetskopiornaVarje natt, krypterade och förvarade utanför maskinen; återställning ingårntfys egna kopior och begäran om återställning, när du behöver den
MigreringenDin nuvarande server migreras kostnadsfrittTidpunkten 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.

ntfy, på en server som sköts åt dig

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.

Upptäck Managed VPS

Vanliga frågor

Är ntfy gratis för ett företag?

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.

Hur installerar man ntfy med Docker Compose?

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.

Hur gör man en ntfy-server privat?

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.

Hur publicerar man till ntfy från ett skript med en token?

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.

Varför ställa in behind-proxy i ntfy?

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.

Når ntfy-notiser en iPhone direkt?

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.

Hur säkerhetskopierar man ntfy?

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.

Täcker en Managed VPS ntfy?

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.

Källor och officiell dokumentation

Kontakta oss