ntfy na VPS: notificações push do seu servidor
ntfy v2.38.0 na VPS: o servidor nasce aberto, então vêm primeiro deny-all, usuário e token; depois Caddy com HTTPS, Android x iPhone, avisos por curl e atualização.
Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: ntfy na VPS: notificações push do seu servidor Arte: Eleven Host
ntfy na VPS é um servidor de notificações push próprio: um script ou uma tarefa agendada manda um aviso por HTTP com curl, e ele chega no celular ou no navegador, com o servidor de notificações na sua própria VPS.
Atualizado em 15/11/2026. Para entender o que é uma VPS antes de instalar, veja O que é servidor VPS: guia simples para iniciantes. Aqui a ordem importa: controle de acesso, usuário e token, e só então domínio e HTTPS.
O que é o ntfy
O ntfy (lê-se como a palavra inglesa notify) é um serviço simples de notificações por HTTP, no modelo de publicar e assinar. Quem publica manda uma mensagem para um tópico, e quem assinou recebe o aviso. Em servidor, serve para avisar que um backup terminou ou que o disco está enchendo.
O projeto é de código aberto, com licença dupla Apache 2.0 e GPLv2. Existe também o serviço público, o ntfy.sh, que é gratuito e não exige cadastro, além de planos pagos dele para quem não quer hospedar ou precisa de limites maiores. Os apps do Android e do iPhone aceitam assinar tópicos de um servidor próprio.
Por padrão, o servidor do ntfy nasce aberto: qualquer pessoa pode ler e publicar em qualquer tópico. Ligue o controle de acesso (auth-file com auth-default-access em deny-all) e crie o usuário e o token antes de abrir a porta ou o domínio para a internet.
Versão atual e correções de segurança
Em 15/11/2026, a versão mais nova é a v2.38.0, publicada em 14/11/2026, e o repositório não está arquivado. O GitHub não mostra avisos de segurança publicados, mas as correções saem nas notas de versão: a v2.38.0, por exemplo, corrige uma negação de serviço em modelos de mensagem. Só a versão mais nova recebe suporte, segundo a política de segurança do projeto. Por isso, recomendamos manter o ntfy atualizado.
ntfy.sh público ou servidor próprio
O projeto informa que a disponibilidade dele é no melhor esforço, que roda numa única máquina, sem redundância, e que os registros contêm nomes de tópicos e IPs. Esses pontos pesam a favor de um servidor próprio.
Para um painel do servidor, veja Netdata na VPS: monitore o servidor em tempo real.
Cobrança mensal, em reais, é o modelo das VPS da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação: Docker ou pacote
A documentação cobre mais de um caminho. Um é o pacote .deb para Debian e Ubuntu (amd64, armhf e arm64), que vem de um repositório apt do projeto, instala o serviço no systemd e lê a configuração em /etc/ntfy/server.yml; os comandos estão na página de instalação do ntfy. O caminho principal aqui é o Docker, com a imagem binwiederhier/ntfy; o Docker precisa estar instalado, e a instalação dele segue a documentação do próprio Docker.
A imagem expõe a interface web e a API na porta 80 do container e não traz um server.yml: você fornece o seu, num volume em /etc/ntfy. Por isso, a configuração vem antes do container.
O ntfy sem configuração é um servidor aberto
O exemplo oficial da documentação publica a porta 80 direto. Nos exemplos abaixo, a porta fica só em 127.0.0.1, e o container só é criado com o controle de acesso já escrito.
Configuração: server.yml com deny-all
Primeiro, as pastas. Um exemplo, não testado, que você deve conferir no próprio servidor:
sudo mkdir -p /etc/ntfy /var/cache/ntfy
Depois, crie o arquivo /etc/ntfy/server.yml com estas linhas:
base-url: "https://ntfy.exemplo.com.br"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
auth-file: "/etc/ntfy/user.db"
auth-default-access: "deny-all"
A base-url é o endereço público e é necessária para o push do iPhone. A behind-proxy manda ler o IP real do visitante no cabeçalho do proxy; sem ela, todos contam como um só no limite de taxa. A cache-file guarda as mensagens em SQLite (por padrão, 12 horas); sem ela, elas não sobrevivem a uma reinicialização. O auth-file é o banco de usuários, criado sozinho. E deny-all é a forma mais simples, segundo a documentação, de montar uma instância privada. Com o auth-file em /etc/ntfy, o banco sobrevive à recriação do container.
Agora o container, com a versão fixada em vez de latest e a porta presa ao próprio servidor. A porta 2586 é uma escolha deste exemplo:
sudo docker run -d --name ntfy --restart unless-stopped -v /var/cache/ntfy:/var/cache/ntfy -v /etc/ntfy:/etc/ntfy -p 127.0.0.1:2586:80 binwiederhier/ntfy:v2.38.0 serve
Confira no Docker Hub se a v2.38.0 ainda é a mais nova. Se não subir, veja sudo docker logs ntfy: desde a v2.36.0, configuração inválida impede a inicialização.
Usuário, acesso e token antes de abrir
Os comandos abaixo vêm da documentação do ntfy, mas rodá-los dentro do container é uma adaptação, não testada. maria é um administrador de exemplo, robo é o usuário que vai publicar os avisos e backups é o tópico. Os dois primeiros pedem a senha no terminal.
sudo docker exec -it ntfy ntfy user add --role=admin maria
sudo docker exec -it ntfy ntfy user add robo
sudo docker exec -it ntfy ntfy access robo backups rw
sudo docker exec -it ntfy ntfy token add --expires=30d --label="backups" robo
O último comando mostra o token. Guarde-o num arquivo protegido; o --expires=30d faz o token vencer em 30 dias, e depois disso é preciso gerar outro. Antes de abrir o domínio, um teste local deve ser recusado por falta de credencial; confira o que o seu servidor responde:
curl -d "teste sem token" http://127.0.0.1:2586/backups
Domínio e HTTPS com proxy reverso
Só agora o servidor pode ganhar um endereço público: o nome de domínio precisa apontar para a VPS (registro DNS) antes de o proxy pedir o certificado. Atrás de um proxy, a documentação recomenda que o próprio proxy termine o TLS. Recomendamos domínio com HTTPS válido em vez de HTTP puro, porque a senha e o token viajam no cabeçalho.
Segundo a documentação do ntfy, o Caddy trata HTTP e WebSockets com reverse_proxy. Um exemplo de Caddyfile, não testado, com o domínio de exemplo trocado pelo seu:
ntfy.exemplo.com.br {
reverse_proxy 127.0.0.1:2586
}
A instalação do Caddy segue a documentação dele. Para o Nginx, a página de configuração do ntfy traz o bloco completo, com os cabeçalhos de WebSocket e o buffering desligado.
Celular: Android e iPhone
No Android, o app está no Google Play, no F-Droid e como APK no GitHub. A versão do F-Droid não usa Firebase, e com servidor próprio nenhuma usa: o app mantém um serviço em primeiro plano, com uma notificação fixa, e o aviso chega até com o celular em modo doze. Dá para desligar esse serviço, mas aí podem vir atrasos grandes; no F-Droid ele não desliga. Com servidor próprio no Android, o app não precisa do ntfy.sh como ponte.
No iPhone, a história é diferente. O app vem da App Store, e o autor o descreve como bem simples e um pouco instável. O iOS limita o processamento em segundo plano, então o aviso rápido precisa de um servidor central. Com servidor próprio, isso se configura com upstream-base-url apontando para o ntfy.sh, e exige a base-url já definida:
upstream-base-url: "https://ntfy.sh"
Depois de acrescentar essa linha ao server.yml e reiniciar o container (sudo docker restart ntfy), o seu servidor manda ao ntfy.sh um aviso de consulta com só o ID da mensagem, e o app busca o conteúdo na sua VPS. Ou seja, o conteúdo fica na VPS, mas o ID da mensagem e um hash do tópico passam pelo ntfy.sh, pelo Firebase e pela Apple. Sem essa linha, segundo a documentação, a entrega no iPhone pode levar horas.
Enviar um aviso do servidor
A publicação é um curl com o token no cabeçalho Authorization. O destino é o domínio de exemplo, para o aviso não sair no servidor público. A mensagem aceita até 4.096 bytes, e a prioridade vai de 1 a 5. Um exemplo, com o token numa variável:
curl -H "Authorization: Bearer $NTFY_TOKEN" -H "Title: Disco quase cheio" -H "Priority: high" -H "Tags: warning" -d "Disco acima do limite em $(hostname)" https://ntfy.exemplo.com.br/backups
Para um aviso de fim de backup ou de tarefa agendada, o padrão é encadear sucesso e falha. Um exemplo, não testado. Uma vez só, no terminal, crie o arquivo do token com permissão só para o seu usuário e cole o token nele com um editor:
install -m 600 /dev/null ~/.ntfy-token
Depois, salve as linhas abaixo num script, que é o que o cron vai chamar. Uma variável exportada no terminal não existe no cron; por isso o script lê o token do arquivo, e o token não fica escrito no crontab, onde ficaria visível:
export NTFY_TOKEN="$(cat ~/.ntfy-token)"
/usr/local/bin/backup.sh \
&& curl -H "Authorization: Bearer $NTFY_TOKEN" -H "Priority: low" -d "Backup OK em $(hostname)" https://ntfy.exemplo.com.br/backups \
|| curl -H "Authorization: Bearer $NTFY_TOKEN" -H "Priority: high" -H "Tags: warning" -d "Backup FALHOU em $(hostname)" https://ntfy.exemplo.com.br/backups
O script backup.sh é o seu, e o artigo Restic na VPS: backup automático do servidor mostra uma forma de montar o backup que esse aviso acompanha.
Backup do próprio ntfy e atualização
Recomendamos guardar server.yml e user.db; cache e anexos são temporários (12 e 3 horas por padrão) e podem ficar de fora. Como a cópia contém credenciais, guarde-a fora da VPS, com acesso restrito.
Para atualizar, recomendamos este caminho, não testado: troque a tag, leia as notas da versão, faça o backup e recrie o container. As notas já avisaram que a v2.31.1 mudou o esquema do banco, e voltar à v2.31.0 ou anterior exige acertar a versão à mão. Recomendamos não pular muitas versões de uma vez.
Para recriar, pare e remova o container e rode o docker run com a tag nova; os volumes preservam os dados.
Um nome para o servidor de avisos
Com proxy e HTTPS, o servidor de avisos passa a ser acessado por um nome de domínio, e esse nome precisa apontar para a VPS.
A pesquisa de domínio disponível na Eleven Host cobre centenas de extensões. Buscar domínio
Perguntas frequentes
O ntfy é gratuito?
O software é de código aberto, com licença dupla Apache 2.0 e GPLv2. O serviço público ntfy.sh tem uso gratuito, e os planos pagos dele são para quem não quer hospedar ou precisa de limites maiores.
O ntfy funciona no iPhone com servidor próprio?
Funciona, mas o aviso rápido depende do ntfy.sh como ponte: só o ID da mensagem passa por ele. Sem isso, a entrega pode levar horas.
Posso abrir o domínio antes de configurar o acesso?
Não é o caminho indicado. O padrão é aberto, e qualquer um poderia ler e publicar até o deny-all estar ligado.
Preciso do Firebase no Android?
Não com servidor próprio: o app usa um serviço em primeiro plano.