Ospitare ntfy su un VPS gestito: notifiche push dal vostro server

Ospitare ntfy su un VPS gestito significa inviare notifiche push con una semplice richiesta HTTP, PUT o POST, da una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. ntfy è un software libero con doppia licenza, Apache 2.0 e GPLv2. Questa guida segue la sua documentazione ufficiale alla versione 2.38.1: l'installazione con Docker Compose, il file server.yml, gli utenti e il controllo degli accessi, i token di accesso, HTTPS, le app mobili, l'e-mail, i backup e gli aggiornamenti.

Simon Vasconcelos Lee Di Pubblicato il 21 novembre 2026Lettura: 15 minuti

Tutte le guide

In breve

  1. ntfy riceve un messaggio tramite una richiesta HTTP PUT o POST verso un topic, e lo inoltra subito ai telefoni, ai browser e agli script iscritti a quel topic.
  2. La sua doppia licenza, Apache 2.0 e GPLv2, consente di farlo girare liberamente in azienda; le sue condizioni si applicano alla ridistribuzione del software.
  3. Installatelo con Docker Compose: l'immagine binwiederhier/ntfy, un server.yml con base-url, cache-file e auth-file, e la porta pubblicata su 127.0.0.1 dietro un reverse proxy in HTTPS.
  4. Per impostazione predefinita, chiunque può leggere e scrivere su tutti i topic: impostate auth-default-access: deny-all, create un amministratore con ntfy user add, poi date a ogni script il proprio token e permessi limitati.
  5. Salvate server.yml e user.db, che contengono la configurazione, gli utenti, i permessi e i token; aggiornate cambiando il tag dell'immagine, dopo aver letto le note di rilascio.

Che cosa fa ntfy

ntfy, che si pronuncia come «notify», è un servizio di notifiche publish-subscribe basato su HTTP. Il suo README lo presenta come un modo di inviare notifiche al telefono o al computer da script, da qualsiasi macchina. Il progetto gestisce un'istanza pubblica, ntfy.sh, e il server può essere self-hosted: è ciò di cui tratta questa guida.

Terminale, un primo messaggio
curl -d "Backup finished" https://ntfy.example.com/backups

Le licenze Apache 2.0 e GPLv2, e il marchio

Il README di ntfy indica che il progetto ha una doppia licenza: la Apache License 2.0, nel file LICENSE, e la GNU GPL versione 2, in LICENSE.GPLv2. L'immagine Docker le dichiara entrambe, Apache-2.0, GPL-2.0.

Far girare ntfy sul vostro server, per la vostra azienda, il vostro team o i vostri clienti, non richiede quindi alcuna licenza da acquistare. Entrambi i testi forniscono il software senza garanzia.

La licenza copre il codice. Il nome è un'altra questione: la Apache License 2.0 non concede alcun diritto sui marchi del licenziante, e i termini di servizio di ntfy.sh indicano che il nome, il logo e l'identità visiva di ntfy sono marchi di ntfy LLC, il cui uso in relazione a un prodotto o a un servizio richiede il suo consenso preventivo scritto. Questa guida nomina ntfy per descrivere il software.

Questa pubblicazione è indipendente dal progetto ntfy e da ntfy LLC, e non è affiliata, sponsorizzata né approvata da loro.

Le risorse da prevedere

Il server è un unico binario collegato staticamente, per amd64, armv7 e arm64; l'immagine Docker esiste anche per armv6. La documentazione non indica alcun valore di memoria o di CPU: per un server domestico, dice, la scala non è motivo di preoccupazione. Indica invece ciò che limita un'istanza:

Su un VPS gestito, parlateci del vostro utilizzo, del numero di dispositivi iscritti, del volume di messaggi e degli allegati, e vi raccomandiamo la taglia adatta.

L'installazione con Docker Compose

La documentazione propone l'immagine binwiederhier/ntfy su Docker Hub. Serve l'app web e l'API sulla porta 80 del container, e non contiene alcun file server.yml: la configurazione va in una cartella montata su /etc/ntfy. Su un server in cui Docker è installato, create una cartella e collocatevi questo compose.yaml, basato sull'esempio della documentazione:

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

Poi il file di configurazione, in etc/server.yml, con l'indirizzo pubblico del vostro 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
Terminale, nella cartella del compose.yaml
docker compose up -d
curl http://127.0.0.1:2586/v1/health

Il server risponde {"healthy":true,"role":"active"}. Che cosa fa ogni impostazione:

Senza Docker: il repository Debian e Ubuntu

Il progetto pubblica anche un repository di pacchetti, firmato con la chiave di impronta 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. Su un server amd64:

Terminale
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

Il pacchetto legge /etc/ntfy/server.yml. Il file di esempio raccomanda /var/cache/ntfy/cache.db per la cache e /var/lib/ntfy/user.db per gli utenti, due cartelle che il pacchetto crea. Dietro un proxy, aggiungete listen-http: "127.0.0.1:2586".

Utenti, controllo degli accessi e token

Di base, un server ntfy è aperto: chiunque può leggere e scrivere su tutti i topic, e il nome del topic fa da password. Con auth-file e deny-all, non passa nulla senza credenziali. ntfy ha due ruoli: admin, che legge e scrive su tutti i topic, e user, che ha solo i permessi che gli concedete.

Terminale, il primo amministratore
docker compose exec ntfy ntfy user add --role=admin alice

Il comando chiede la password, poi la sua conferma. I comandi ntfy user, ntfy access e ntfy token scrivono direttamente nel database degli utenti: girano sul server, qui dentro il container, che legge il percorso di quel database in server.yml.

Un utente e un token per script

Al momento, un token di accesso dà pieno accesso all'account del suo utente, tranne per cambiare la password ed eliminare l'account. Per uno script, create un utente dedicato, limitato ai suoi topic, poi un token per lui:

Terminale
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

Lo script pubblica poi con il suo token, in HTTPS:

Terminale, sulla macchina che pubblica
curl \
  -H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -d "The nightly backup went fine." \
  https://ntfy.example.com/backups

Una password in Basic auth è solo codificata in base64, non cifrata: la documentazione chiede HTTPS su ogni server self-hosted. È l'argomento della sezione successiva.

HTTPS: il reverse proxy

ntfy può servire HTTPS da solo, ma dietro un proxy la documentazione raccomanda di lasciare la terminazione TLS al proxy. Due punti contano più di tutto il resto:

Con Caddy

La documentazione osserva che Caddy gestisce sia HTTP sia WebSocket con reverse_proxy, senza impostazioni aggiuntive. Ottiene da solo il certificato Let's Encrypt:

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

Con Nginx

Questo blocco segue la configurazione della documentazione, vicina a quella usata da ntfy.sh: il buffering disattivato per i flussi, timeout di 3 minuti e nessun limite di dimensione sul corpo delle richieste, che ntfy limita da solo. Ascolta sulla porta 80 per lasciare a Certbot l'attivazione di 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;
    }
}
Terminale
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com

Una volta che HTTP reindirizza verso HTTPS, pubblicate su indirizzi https:// nei vostri script. Per migliaia di iscritti, la documentazione alza worker_connections in nginx.conf e il LimitNOFILE del servizio Nginx, al doppio delle connessioni che si vogliono sostenere.

Le app Android, iOS e web

Le app ntfy aggiungono i topic del vostro server come quelli di ntfy.sh: inserite il suo indirizzo quando aggiungete il topic e, per un topic protetto, il nome utente e la password di un utente che vi ha accesso. L'app web è servita all'indirizzo stesso del server.

Le notifiche istantanee su iOS

Aggiungete una riga a server.yml, poi riavviate il container:

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

Per ogni messaggio, il vostro server pubblica allora su ntfy.sh una richiesta di polling, che contiene solo l'ID del messaggio e l'hash SHA-256 dell'URL del topic. ntfy.sh la trasmette al dispositivo tramite il servizio di notifiche di Apple, poi l'app recupera il messaggio dal vostro server. Il testo che passa da ntfy.sh è sempre lo stesso, «New message», qualunque cosa dica il vostro. Senza questa impostazione, le notifiche arrivano comunque, con un ritardo che può raggiungere diverse ore a seconda dello stato del telefono. upstream-access-token aggiunge un token se superate i limiti di frequenza di ntfy.sh.

I limiti di frequenza e gli allegati

ntfy limita ogni visitatore, identificato dal suo indirizzo IP e, in IPv6, dalla sua sottorete /64. Questi limiti proteggono il server dagli abusi; in un uso normale, dice la documentazione, non dovreste raggiungerli. Oltre, il server risponde 429 Too Many Requests. I valori predefiniti:

ImpostazionePredefinitoChe cosa limita
visitor-request-limit-burst60Le richieste di un visitatore in una raffica
visitor-request-limit-replenish5sIl ritmo di ricarica: una richiesta ogni 5 secondi
visitor-subscription-limit30Le connessioni aperte per visitatore
visitor-message-daily-limitNessunoI messaggi al giorno, altrimenti regolati dal limite di richieste
visitor-email-limit-burst16Le e-mail in una raffica, poi una all'ora
visitor-attachment-total-size-limit100MLo spazio per gli allegati per visitatore
visitor-attachment-daily-bandwidth-limit500MIl traffico degli allegati per visitatore al giorno
global-topic-limit15.000Il numero totale di topic del server
message-size-limit4KLa dimensione di un messaggio; oltre, diventa un allegato

Le notifiche via e-mail

ntfy può inoltrare un messaggio via e-mail quando la richiesta di pubblicazione porta l'intestazione Email, o X-Email, con un indirizzo. Per farlo passa da un server SMTP in uscita, in STARTTLS, con autenticazione PLAIN o LOGIN: è la porta 587. Da un VPS Simafri, l'e-mail esce tramite un relay SMTP autenticato su quella stessa porta 587: configurate qui l'indirizzo di un account e-mail che avete già, oppure quello del vostro servizio di invio di e-mail.

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

I backup

Con SQLite, ntfy conserva ogni tipo di dati in un file a sé. Nell'installazione di questa guida, tutto si trova nelle cartelle etc e lib, accanto al compose.yaml:

ElementoChe cosa conservaDa salvare
etc/server.ymlLa configurazione, compresi i segreti SMTP e le chiavi Web PushSì
lib/user.dbUtenti, voci di controllo degli accessi, token e contatori giornalieriSì
lib/cache.dbI messaggi delle ultime 12 ore, per impostazione predefinitaUtile, la sua durata è breve
lib/attachments/Gli allegati delle ultime 3 ore, per impostazione predefinitaUtile, la sua durata è breve
File web-push-fileLe iscrizioni Web Push dei browser, se l'avete attivatoSì

Per una copia coerente dei file SQLite, fermate il servizio mentre viene creato l'archivio:

Terminale, nella cartella del compose.yaml
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start

Pianificate questa copia in un orario tranquillo, e inviatela fuori dal server. Collocati sul suo disco, questi archivi rientrano anche nei suoi backup notturni. Per ripristinare, rimettete le cartelle al loro posto, poi lanciate docker compose up -d.

Se perdete user.db senza alcuna copia, gli utenti e i token dichiarati in server.yml tramite auth-users e auth-tokens vengono ricreati all'avvio; quelli creati dalla riga di comando vanno creati di nuovo.

Gli aggiornamenti

Con Docker, cambiate il tag dell'immagine in compose.yaml, per esempio da v2.38.1 alla versione successiva, poi:

Terminale, nella cartella del compose.yaml
docker compose pull
docker compose up -d

Le cartelle etc e lib restano al loro posto, e ntfy migra da solo i suoi database all'avvio. Con il pacchetto Debian, sudo apt update poi sudo apt upgrade fanno lo stesso.

Le note di ogni versione, nella pagina «Releases» della documentazione, raccolgono in «Upgrade notes» ciò che cambia per un'istanza esistente, come, nella 2.36.0, una configurazione ora verificata per intero all'avvio, o i contatori giornalieri azzerati. Leggetele prima di aggiornare, e copiate le due cartelle subito prima. La versione 2.38.1 è una versione di sicurezza, fortemente raccomandata dal progetto: rafforza i modelli dei messaggi contro gli attacchi di negazione del servizio e impedisce che i caricamenti lenti di allegati verso S3 e gli endpoint web push che non rispondono tengano occupate memoria e connessioni. Segue la 2.38.0, che condivide i limiti di frequenza tra i nodi di un cluster ed è compilata con Go 1.27.4.

Chi fa che cosa su un VPS gestito

Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; ntfy resta il vostro software, con le sue impostazioni e i suoi dati.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto alla vostra attività
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa lettura dei log della vostra istanza
ntfyMonitoraggio proattivo: errori, rallentamenti, connessioni aperte e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA
Gli accessiIl server che lo ospita, sorvegliato e salvatoGli utenti, i permessi sui topic e i token dei vostri script
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoLe copie proprie di ntfy e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl momento del passaggio

Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.

ntfy, su un server gestito per voi

Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza ntfy, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.

Scoprire i VPS gestiti

Domande frequenti

ntfy è gratuito per un'azienda?

Sì. ntfy ha una doppia licenza, Apache 2.0 e GPLv2: potete farlo girare in azienda senza alcuna licenza da acquistare. Le loro condizioni si applicano alla ridistribuzione del software. Resta il costo del server che lo fa girare.

Come installare ntfy con Docker Compose?

Create un compose.yaml con l'immagine binwiederhier/ntfy, il comando serve, una cartella montata su /etc/ntfy per server.yml, un'altra su /var/lib/ntfy per i database, e la porta 80 del container pubblicata su 127.0.0.1:2586. Lanciate docker compose up -d, poi collocate un reverse proxy in HTTPS davanti a quella porta.

Come rendere privato un server ntfy?

In server.yml, impostate auth-file e auth-default-access: deny-all. Create poi un amministratore con ntfy user add --role=admin, utenti limitati con ntfy user add, e i loro permessi sui topic con ntfy access.

Come pubblicare su ntfy da uno script con un token?

Create un token con ntfy token add per un utente dedicato allo script, limitato ai suoi topic, poi pubblicate con curl e l'intestazione Authorization: Bearer seguita dal token, in HTTPS. Un token dà accesso all'intero account del suo utente.

Perché impostare behind-proxy in ntfy?

Dietro un reverse proxy, ogni richiesta arriva dall'indirizzo del proxy. Con behind-proxy: true, ntfy legge l'intestazione X-Forwarded-For per identificare ogni visitatore; senza, condividono tutti gli stessi limiti di frequenza.

Le notifiche di ntfy arrivano subito su un iPhone?

Sì, con upstream-base-url: "https://ntfy.sh" in server.yml. Il vostro server fa allora inoltrare da ntfy.sh un segnale che contiene solo l'ID del messaggio, e l'app recupera il messaggio dal vostro server. Senza questa impostazione, la consegna può richiedere diverse ore.

Come fare il backup di ntfy?

Salvate server.yml e user.db, che contengono la configurazione, gli utenti, i permessi e i token, più il file Web Push se è attivato. La cache dei messaggi e gli allegati hanno una durata breve. Fermate il servizio durante la copia, per avere file SQLite coerenti.

Un VPS gestito copre ntfy?

Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.

Contattaci