Guía Completa de Ntfy: Cómo Configurar y Solucionar Problemas de Notificaciones Push

Última actualización: 24/06/2026

  • Ntfy es un sistema de publicación y suscripción basado en REST que permite enviar alertas instantáneas a múltiples dispositivos sin configuraciones complejas.
  • Soporta la implementación de servidores propios mediante Docker, permitiendo un control total sobre la privacidad y la gestión de usuarios y permisos.
  • Es compatible con una amplia gama de integraciones, desde scripts de PowerShell y peticiones HTTP hasta el estándar Unified Push en Android.
  • Requiere configuraciones específicas de red y URL públicas para asegurar la recepción de notificaciones push en dispositivos iOS.
Configurar y Solucionar Problemas de Notificaciones Push en ntfy

Si alguna vez te has sentido un poco escéptico confiando toda tu información sensible a gigantes como Google, Apple o incluso Telegram, sabrás que buscar una alternativa de notificaciones propia es casi un deporte de riesgo. A veces basta con que un servicio se caiga o cambie sus políticas para que nos quedemos a ciegas sobre lo que ocurre en nuestros servidores o aplicaciones, y es ahí donde entra en juego una herramienta tan versátil como ntfy (que, por cierto, se pronuncia «notify»).

Básicamente, estamos ante un sistema de publicación-suscripción basado en REST que nos permite lanzar alertas a temas específicos sin tener que montar una infraestructura mastodóntica. Es una opción ideal para quienes buscan simplicidad pero que no quieren renunciar a la potencia de automatizar procesos, ya sea mediante scripts sencillos o integraciones más avanzadas, manteniendo siempre el control total de los datos.

Related article:
¿Cómo puedo recibir notificaciones push?

Cómo poner en marcha tu propio servidor de ntfy

Cómo poner en marcha tu propio servidor de ntfy

Para los que prefieren no complicarse la vida con instalaciones manuales de binarios, la mejor ruta es tirar de Docker y Docker Compose. Es la forma más limpia de mantener el servicio y facilita enormemente las actualizaciones. Solo necesitas un archivo docker-compose.yml básico donde definas el usuario y grupo para evitar problemas de permisos en Linux y expongas el puerto 80 para poder acceder al panel.

Contenido exclusivo - Clic Aquí  ¿Cómo usar plantillas en Capcut?

Para que todo ruede como la seda, es fundamental crear dos directorios: uno para la caché de datos (donde se guardarán imágenes o archivos adjuntos) y otro para la configuración. En este último es donde vive el archivo server.yml, que es el corazón del servidor. Aquí hay algunos parámetros que no puedes pasar por alto:

  • base-url: Es la dirección pública de tu servidor. Si no la pones, los dispositivos iOS no sabrán dónde buscar las notificaciones y los enlaces de descarga fallarán.
  • auth-default-access: Si quieres que tu servidor sea privado y no cualquiera pueda leer tus alertas, configúralo como deny-all.
  • behind-proxy: Si usas Cloudflare, Nginx o Traefik, marca esta opción como true para que el servidor gestione correctamente las cabeceras.
  • attachment-cache-dir: Define dónde se almacenarán los archivos temporales y cuánto espacio máximo pueden ocupar para que no se te llene el disco por un descuido.
  • upstream-base-url: Muy importante para iOS; aquí se indica el servidor que servirá de puente para las notificaciones de Apple y Google.
Related article:
¿Cómo configurar las notificaciones push en mi dispositivo iOS?

Gestión de usuarios y control de acceso

Una vez que el contenedor está arriba, no puedes dejar la puerta abierta de par en par. Para gestionar quién entra y quién sale, lo ideal es entrar en la consola del contenedor mediante docker exec y utilizar el comando ntfy user add para crear cuentas individuales. Puedes asignar el rol de administrador a quienes necesiten control total sobre todos los tópicos.

La magia de ntfy reside en su sistema de permisos por temas. Si quieres que un usuario específico solo pueda leer y escribir en los temas que empiecen por «casa-«, basta con ejecutar un comando de acceso usando comodines. Por otro lado, si necesitas que aplicaciones de Android que usen el estándar Unified Push funcionen, deberás dar permisos de lectura y escritura al usuario everyone para los temas que empiecen por «up*».

Contenido exclusivo - Clic Aquí  YouTube renueva los filtros de búsqueda para ajustar mejor los resultados

Formas de recibir y enviar alertas

Formas de recibir y enviar alertas en ntfy

La flexibilidad de este sistema es brutal. Para recibir mensajes, simplemente te suscribes a un tema (que básicamente es una ruta en la URL) a través de la interfaz web, la aplicación móvil o la de iOS. El proceso es tan sencillo como elegir un nombre único para evitar que algún curioso acabe suscrito a tus alertas por pura coincidencia.

Para enviar la información, tienes un abanico enorme de opciones: curl para los más puristas de la terminal, el binario ntfy-cli o incluso scripts de PowerShell en Windows Server. En este último caso, es común toparse con errores de certificados; para solucionarlo, se recomienda realizar una petición POST incluyendo la autenticación Bearer codificada en base64 para garantizar que el mensaje llegue a su destino sin problemas.

notificaciones web siguen llegando con el navegador apagado
Related article:
Por qué las notificaciones web siguen llegando con el navegador cerrado y cómo controlarlas

Además, ntfy permite subir el nivel de la notificación. Puedes añadir tags para mostrar emojis, establecer la prioridad (desde mínima hasta urgente) y hasta crear botones de acción. Imagina recibir una alerta de que la temperatura de tu servidor es muy alta y tener un botón en la misma notificación para ejecutar un script de enfriamiento o apagar un equipo remotamente.

Contenido exclusivo - Clic Aquí  ¿Cómo mirar fotos en la tele a través de google photos?

Solución de problemas comunes: El dolor de cabeza de iOS y Android

Uno de los problemas más frecuentes ocurre en iPhone, donde el usuario ve que todo funciona en la web pero que las notificaciones push nunca llegan a menos que abra la aplicación y refresque manualmente. Esto suele deberse a que los dispositivos iOS requieren que el servidor sea accesible desde internet vía HTTPS (puertos 80/443) para que el servicio de notificaciones de Apple pueda entregar el mensaje.

Si tienes el servidor en una red local sin abrir puertos, es probable que la app no reciba el «empujón» necesario para despertar y mostrar la alerta. En Android, aunque es más flexible, es vital asegurarse de que la app tenga los permisos necesarios y, si usas F-Droid o Google Play, verificar que el ahorro de energía no esté matando el proceso de fondo de ntfy, ya que a veces las notificaciones de Android llegan con retraso.

Existen también integraciones interesantes como el envío de alertas mediante correo electrónico, donde el asunto del mail se convierte en el tema de la notificación. Incluso es posible convertir archivos adjuntos en enlaces temporales simplemente añadiendo un marcador como en el asunto, lo que hace que el flujo de información sea más dinámico y eficiente.

Cualquier persona que desee centralizar sus avisos de Uptime Kuma, scripts de servidor o sensores de temperatura encontrará en ntfy una herramienta robusta. Solo hace falta configurar correctamente la URL pública y los permisos de acceso para disfrutar de un sistema de notificaciones en tiempo real que no dependa de terceros y sea extremadamente ligero tanto para el servidor como para el dispositivo móvil.