Hoste ntfy på en Managed VPS: pushnotifikationer fra din egen server

At hoste ntfy på en Managed VPS betyder, at du sender pushnotifikationer med en almindelig HTTP-anmodning, PUT eller POST, fra en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. ntfy er fri software med dobbelt licens, Apache 2.0 og GPLv2. Denne guide følger den officielle dokumentation i version 2.38.1: installation med Docker Compose, filen server.yml, brugere og adgangskontrol, adgangstokens, HTTPS, mobilapps, e-mail, backup og opdateringer.

Simon Vasconcelos Lee Af Udgivet den 21. november 2026Læsetid: 15 minutter

Alle guider

Det vigtigste

  1. ntfy modtager en besked via en HTTP-anmodning PUT eller POST til et topic og sender den straks videre til de telefoner, browsere og scripts, der abonnerer på det topic.
  2. Den dobbelte licens, Apache 2.0 og GPLv2, giver dig frihed til at køre ntfy i din virksomhed; dens betingelser gælder for videredistribution af softwaren.
  3. Installér med Docker Compose: imaget binwiederhier/ntfy, en server.yml med base-url, cache-file og auth-file og porten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.
  4. Som standard kan alle læse og skrive i alle topics: sæt auth-default-access: deny-all, opret en administrator med ntfy user add, og giv derefter hvert script sit eget token og begrænsede rettigheder.
  5. Tag backup af server.yml og user.db, som rummer konfigurationen, brugerne, rettighederne og tokens; opdatér ved at ændre imagets tag, efter at du har læst release notes.

Hvad ntfy gør

ntfy, der udtales «notify», er en HTTP-baseret notifikationstjeneste efter publish-subscribe-princippet. Dens README præsenterer den som en måde at sende notifikationer til din telefon eller din computer fra scripts, fra en hvilken som helst computer. Projektet driver en offentlig instans, ntfy.sh, og serveren kan hostes selv: det er emnet for denne guide.

Terminal, en første besked
curl -d "Backup finished" https://ntfy.example.com/backups

Licenserne Apache 2.0 og GPLv2, og varemærket

ntfys README oplyser, at projektet har dobbelt licens: Apache License 2.0, i filen LICENSE, og GNU GPL version 2, i LICENSE.GPLv2. Docker-imaget angiver begge, Apache-2.0, GPL-2.0.

At køre ntfy på din server, for din virksomhed, dit team eller dine kunder, kræver altså ingen licens at købe. Begge tekster leverer softwaren uden garanti.

Licensen dækker koden. Navnet er en anden sag: Apache License 2.0 giver ingen rettigheder til licensgiverens varemærker, og servicevilkårene for ntfy.sh oplyser, at navnet, logoet og den visuelle identitet for ntfy er varemærker tilhørende ntfy LLC, og at brug af dem i forbindelse med et produkt eller en tjeneste kræver deres forudgående skriftlige samtykke. Denne guide nævner ntfy for at beskrive softwaren.

Denne publikation er uafhængig af ntfy-projektet og ntfy LLC og er hverken tilknyttet, sponsoreret eller godkendt af dem.

De ressourcer, du skal regne med

Serveren er en enkelt, statisk linket binærfil til amd64, armv7 og arm64; Docker-imaget findes også til armv6. Dokumentationen opgiver ingen tal for hukommelse eller CPU: for en server derhjemme, siger den, er skalering ikke noget at bekymre sig om. I stedet peger den på det, der sætter grænsen for en instans:

På en Managed VPS fortæller du os om dit brug, antallet af abonnerende enheder, mængden af beskeder og de vedhæftede filer, og vi anbefaler den størrelse, der passer.

Installation med Docker Compose

Dokumentationen tilbyder imaget binwiederhier/ntfy fra Docker Hub. Det leverer webappen og API'et på containerens port 80 og indeholder ingen fil server.yml: konfigurationen lægges i en mappe, der er monteret på /etc/ntfy. Opret en mappe på en server med Docker installeret, og læg denne compose.yaml i den, baseret på dokumentationens eksempel:

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

Derefter konfigurationsfilen, i etc/server.yml, med din servers offentlige adresse:

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

Serveren svarer {"healthy":true,"role":"active"}. Hvad hver indstilling gør:

Uden Docker: repositoriet til Debian og Ubuntu

Projektet udgiver også et pakkerepositorium, signeret med nøglen med fingeraftrykket 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

Pakken læser /etc/ntfy/server.yml. Eksempelfilen anbefaler /var/cache/ntfy/cache.db til cachen og /var/lib/ntfy/user.db til brugerne, to mapper, som pakken opretter. Bag en proxy tilføjer du listen-http: "127.0.0.1:2586".

Brugere, adgangskontrol og tokens

Fra start er en ntfy-server åben: alle kan læse og skrive i alle topics, og topicets navn fungerer som adgangskode. Med auth-file og deny-all slipper intet igennem uden loginoplysninger. ntfy har to roller: admin, der læser og skriver i alle topics, og user, der kun har de rettigheder, du giver den.

Terminal, den første administrator
docker compose exec ntfy ntfy user add --role=admin alice

Kommandoen beder om adgangskoden og derefter om at bekræfte den. Kommandoerne ntfy user, ntfy access og ntfy token skriver direkte i brugerdatabasen: de kører på serveren, her inde i containeren, som læser stien til databasen fra server.yml.

Én bruger og ét token pr. script

Et adgangstoken giver i dag fuld adgang til brugerens konto, bortset fra at ændre adgangskoden og slette kontoen. Til et script opretter du en dedikeret bruger, begrænset til sine topics, og derefter et token til 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

Scriptet publicerer derefter med sit token, over HTTPS:

Terminal, på den maskine, der publicerer
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -d "The nightly backup went fine." \
  https://ntfy.example.com/backups

En adgangskode i Basic auth er kun base64-kodet, ikke krypteret: dokumentationen kræver HTTPS på enhver selvhostet server. Det er emnet for næste afsnit.

HTTPS: reverse proxyen

ntfy kan selv levere HTTPS, men bag en proxy anbefaler dokumentationen at overlade TLS-termineringen til proxyen. To punkter betyder mere end alt andet:

Med Caddy

Dokumentationen bemærker, at Caddy håndterer både HTTP og WebSockets med reverse_proxy, uden ekstra indstillinger. Den henter selv certifikatet fra Let’s Encrypt:

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

Med Nginx

Denne blok følger dokumentationens konfiguration, tæt på den, ntfy.sh kører: buffering slået fra for streams, timeouts på 3 minutter og ingen størrelsesgrænse for anmodningers indhold, som ntfy selv begrænser. Den lytter på port 80, så Certbot kan sætte HTTPS op:

/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 viderestiller til HTTPS, publicerer du til https://-adresser i dine scripts. Til tusindvis af abonnenter hæver dokumentationen worker_connections i nginx.conf og Nginx-tjenestens LimitNOFILE til det dobbelte af det antal forbindelser, du sigter efter.

Apps til Android, iOS og web

ntfy-apps tilføjer topics fra din server på samme måde som fra ntfy.sh: indtast serverens adresse, når du tilføjer topicet, og for et beskyttet topic brugernavn og adgangskode for en bruger, der har adgang til det. Webappen leveres på serverens egen adresse.

Øjeblikkelige notifikationer på iOS

Tilføj én linje til server.yml, og genstart derefter containeren:

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

For hver besked publicerer din server så en poll-anmodning til ntfy.sh, som kun indeholder beskedens ID og SHA-256-hashen af topicets URL. ntfy.sh sender den videre til enheden via Apples notifikationstjeneste, hvorefter appen henter beskeden fra din server. Den tekst, der går via ntfy.sh, er altid den samme, «New message», uanset hvad din besked siger. Uden denne indstilling når notifikationerne stadig frem, med en forsinkelse, der kan nå op på flere timer afhængigt af telefonens tilstand. upstream-access-token tilføjer et token, hvis du overskrider hastighedsgrænserne hos ntfy.sh.

Hastighedsgrænser og vedhæftede filer

ntfy begrænser hver besøgende, identificeret ved sin IP-adresse og for IPv6 ved sit /64-subnet. Disse grænser beskytter serveren mod misbrug; ved normal brug bør du ifølge dokumentationen ikke støde på dem. Ud over dem svarer serveren 429 Too Many Requests. Standardværdierne:

IndstillingStandardHvad den begrænser
visitor-request-limit-burst60En besøgendes anmodninger i ét ryk
visitor-request-limit-replenish5sGenopfyldningstakten: én anmodning hvert 5. sekund
visitor-subscription-limit30Åbne forbindelser pr. besøgende
visitor-message-daily-limitIngenBeskeder pr. dag, ellers styret af grænsen for anmodninger
visitor-email-limit-burst16E-mails i ét ryk, derefter én pr. time
visitor-attachment-total-size-limit100MLagerplads til vedhæftede filer pr. besøgende
visitor-attachment-daily-bandwidth-limit500MTrafik med vedhæftede filer pr. besøgende pr. dag
global-topic-limit15.000Serverens samlede antal topics
message-size-limit4KEn beskeds størrelse; ud over den bliver den til en vedhæftet fil

Notifikationer via e-mail

ntfy kan videresende en besked via e-mail, når publiceringsanmodningen har headeren Email, eller X-Email, med en adresse. Til det går den gennem en udgående SMTP-server, med STARTTLS og godkendelse via PLAIN eller LOGIN: det er port 587. Fra en Simafri VPS går afsendelsen gennem et autentificeret SMTP-relay på samme port 587: angiv her adressen på en e-mailkonto, du allerede har, eller på din afsendertjeneste.

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

Backup

Med SQLite holder ntfy hver type data i sin egen fil. I denne guides installation ligger alt i mapperne etc og lib, ved siden af compose.yaml:

ElementHvad det rummerTag backup
etc/server.ymlKonfigurationen, herunder SMTP-hemmeligheder og Web Push-nøglerJa
lib/user.dbBrugere, regler for adgangskontrol, tokens og daglige tællereJa
lib/cache.dbBeskeder fra de seneste 12 timer, som standardNyttigt, levetiden er kort
lib/attachments/Vedhæftede filer fra de seneste 3 timer, som standardNyttigt, levetiden er kort
Filen web-push-fileBrowsernes Web Push-abonnementer, hvis du har aktiveret detJa

For at få en konsistent kopi af SQLite-filerne stopper du tjenesten, mens arkivet laves:

Terminal, i mappen med compose.yaml
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start

Planlæg denne kopi på et roligt tidspunkt, og send den væk fra serveren. Lagt på dens disk indgår disse arkiver også i dens natlige backup. For at gendanne lægger du mapperne tilbage på plads og kører derefter docker compose up -d.

Mister du user.db uden kopi, genskabes de brugere og tokens, der er erklæret i server.yml via auth-users og auth-tokens, ved start; dem, der er oprettet på kommandolinjen, opretter du igen.

Opdateringer

Med Docker ændrer du imagets tag i compose.yaml, for eksempel fra v2.38.1 til den næste version, og derefter:

Terminal, i mappen med compose.yaml
docker compose pull
docker compose up -d

Mapperne etc og lib bliver, hvor de er, og ntfy migrerer selv sine databaser ved start. Med Debian-pakken gør sudo apt update og derefter sudo apt upgrade det samme.

Noterne til hver version, på dokumentationens side «Releases», samler under «Upgrade notes» det, der ændrer sig for en eksisterende instans, som i 2.36.0 en konfiguration, der nu kontrolleres fuldt ud ved start, eller daglige tællere, der nulstilles. Læs dem før opdateringen, og kopiér begge mapper lige før. Version 2.38.1 er en sikkerhedsudgivelse, som projektet kraftigt anbefaler: den styrker beskedskabelonerne mod denial of service-angreb og forhindrer, at langsomme upload af vedhæftede filer til S3 og web push-endepunkter, der ikke svarer, binder hukommelse og forbindelser. Den følger efter 2.38.0, som deler hastighedsgrænserne mellem et clusters noder og er bygget med Go 1.27.4.

Hvem gør hvad på en Managed VPS

Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; ntfy forbliver din software, med dens indstillinger og data.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldGennemlæsning af din instans' logfiler
ntfyProaktiv opfølgning: fejl, langsomme svartider, åbne forbindelser og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent
AdgangenDen server, der bærer den, overvåget og sikkerhedskopieretBrugerne, rettighederne til topics og dine scripts' tokens
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetDe kopier, der er specifikke for ntfy, og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet for omlægningen

Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.

ntfy på en server, der passes for dig

Med en Managed VPS fra Simafri holder vores teams serveren bag din ntfy-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.

Opdag Managed VPS

Ofte stillede spørgsmål

Er ntfy gratis for en virksomhed?

Ja. ntfy har dobbelt licens, Apache 2.0 og GPLv2: du kan køre den i din virksomhed uden at skulle købe en licens. Deres betingelser gælder for videredistribution af softwaren. Tilbage er udgiften til den server, der kører den.

Hvordan installerer man ntfy med Docker Compose?

Opret en compose.yaml med imaget binwiederhier/ntfy, kommandoen serve, en mappe monteret på /etc/ntfy til server.yml, en anden på /var/lib/ntfy til databaserne og containerens port 80 publiceret på 127.0.0.1:2586. Kør docker compose up -d, og sæt derefter en reverse proxy med HTTPS foran den port.

Hvordan gør man en ntfy-server privat?

I server.yml sætter du auth-file og auth-default-access: deny-all. Opret derefter en administrator med ntfy user add --role=admin, begrænsede brugere med ntfy user add og deres rettigheder til topics med ntfy access.

Hvordan publicerer man til ntfy fra et script med et token?

Opret et token med ntfy token add til en bruger, der er dedikeret til scriptet og begrænset til dets topics, og publicér derefter med curl og headeren Authorization: Bearer efterfulgt af tokenet, over HTTPS. Et token giver adgang til hele brugerens konto.

Hvorfor sætte behind-proxy i ntfy?

Bag en reverse proxy kommer hver anmodning fra proxyens adresse. Med behind-proxy: true læser ntfy headeren X-Forwarded-For for at identificere hver besøgende; uden den deler de alle de samme hastighedsgrænser.

Når ntfy-notifikationer frem til en iPhone med det samme?

Ja, med upstream-base-url: "https://ntfy.sh" i server.yml. Din server lader så et signal gå via ntfy.sh, som kun indeholder beskedens ID, og appen henter beskeden fra din server. Uden denne indstilling kan leveringen tage flere timer.

Hvordan tager man backup af ntfy?

Tag backup af server.yml og user.db, som rummer konfigurationen, brugerne, rettighederne og tokens, plus Web Push-filen, hvis den er aktiveret. Beskedcachen og de vedhæftede filer har en kort levetid. Stop tjenesten, mens du kopierer, for at få konsistente SQLite-filer.

Dækker en Managed VPS ntfy?

En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.

Kilder og officiel dokumentation

Kontakt os