Monitor server and service status and receive alerts with this self-hosted tool
When you need to check in real time whether a website is down, if a server is responding, or if a domain certificate is about to expire, this tool is necessary. Uptime Kuma is a self-hosted monitoring solution that periodically checks the status of various protocols and sends immediate alerts when issues arise. It can be deployed quickly with Docker without complex configuration, making it easy to adopt for everything from personal projects to small teams.
Monitored targets and notification channels
It checks the availability of various targets, including HTTP, TCP, WebSocket, Ping, DNS records, Docker containers, and Steam game servers. It also features the ability to verify specific keywords or JSON values in HTTP responses, allowing you to validate normal service operation beyond simple connection checks. The check interval can be set in 20-second increments, and when a problem is detected, you are immediately notified through more than 90 notification services, such as Telegram, Discord, Slack, and email (SMTP). You can also create multiple status pages and map them to specific domains to publicly disclose service status externally.
Deployment methods and system requirements
The easiest deployment method is using Docker Compose. After downloading the compose.yaml file, simply run the docker compose up -d command to start the service on port 3001. If you install it directly without using Docker, you need Node.js 20.4 or higher, Git, and pm2 for background execution. Supported platforms include major Linux distributions such as Debian, Ubuntu, Fedora, and ArchLinux, as well as Windows 10 (x64) or higher; FreeBSD, OpenBSD, NetBSD, Replit, and Heroku are not supported. Network file systems like NFS are not supported, so data volumes must be mapped to local directories or volumes.
Things to check before use
Since this tool is self-hosted, the responsibility for server management and security lies with the user. The official demo server deletes data after 10 minutes, so you must install it on your own server for actual production environments. Be careful that uptimekuma.co, which appears at the top of Google search results, is not the official website; it is safer to refer to the wiki of this repository for installation guides. Additionally, the author does not provide technical support via email, so problem resolution must be done through GitHub Issues or the subreddit (r/UptimeKuma). You can check the latest beta version or update methods in the wiki documentation.