Uptime Kuma with Push Notifications Stack

Uptime Kuma with Push Notifications Stack

Docker Compose stack pairing Uptime Kuma with Ntfy for instant push notifications to your phone. Pre-configured notification templates for both down and recovery events — no external services or paid plans required.

What Is Included

• Uptime Kuma — Self-hosted uptime monitoring with HTTP, TCP, DNS, and ping check types
• Ntfy — Self-hosted push notification server; subscribe on Android or iOS for free
• Pre-configured Notification Templates — Down and recovery message templates ready to import into Uptime Kuma

How It Works

• Run docker compose up -d — both services start with persistent named volumes
• Open Uptime Kuma, add a notification using the Ntfy webhook URL (pre-filled in the README)
• Subscribe to your Ntfy topic in the Ntfy mobile app to receive push notifications instantly
• Down and recovery messages include monitor name, URL, response code, and timestamp

What You Get

• docker-compose.yml — Uptime Kuma and Ntfy with persistent volumes
• ntfy/server.yml — Ntfy server configuration
• templates/down.md and templates/recovery.md — notification message templates
• .env.example and README.md

Service URLs

Requirements

Docker Engine with the Compose plugin. Ntfy app on Android or iOS (free) for mobile push notifications. No external accounts needed.