Uptime Kuma – A Fancy Self-Hosted Monitoring Tool

Uptime Kuma is an open-source, free and easy-to-use self-hosted monitoring tool. Uptime Kuma is compatible with multiple platforms including Linux, Windows 10 (x64) and Windows Server. Whether you are monitoring a personal website, VPS, home server, Docker container, APIs or business infrastructure, this tool provides a simple way to know when something goes down and when it comes back online.

Monitoring uptime has never been easier and Uptime Kuma offers exactly this, with a simple but effective and powerful dashboard. Instead of repeatedly checking your websites and services manually, it monitors them automatically and alerts you when they go down.

Download

Getting Started

Navigation

Why Uptime Kuma?
Getting Started
Screenshots
Powered by Modern Technologies
Features and Requirements
Frequently Asked Questions

Why Uptime Kuma?

With over 11 unique features, open-source code and free of cost nature, Uptime Kuma is one of the best monitoring tools available out there. It gets continuous improvements and can monitor simple websites to more complex environments involving Docker Containers, SQL Databases and game servers.

Monitoring Uptime

Monitoring uptime for any network service is now a breeze, Uptime Kuma can monitor HTTP and HTTPS URLs, TCP Ports and HTTP(s) Keywords, HTTP and HTTPs JSON queries, Databases, Ping IP addresses or Domain Names, DNS records, Steam Game Servers and even Docker Containers.

Beautiful Ping Charts

Who doesn’t love looking at a chart for a better view of the data they have. The Ping monitoring data collected by Uptime Kuma is visualized beautifully by being displayed in a chart that is interactive, fluid and easy to understand. These charts are available for every monitored host you have added.

Short Monitoring Intervals

Uptime Kuma supports very short 20-second monitoring intervals. This means that it can check any hostname, IP, website, Web App, DNS record or Keyword every 20 seconds. This is enterprise-grade monitoring and mostly enough to alert you for any short periods of downtime your infrastructure may be experiencing.

SSL Certificate Monitoring

TLS/SSL Certificate monitoring is now available for your domains or apps. You can check if the URL is reachable via HTTPS or not and if there are any anomalies or incorrect HTTP status codes being sent along with any SSL expirations coming up so you can renew the TLS certificates in a timely manner.

Beautiful UI/UX

If a beautiful dashboard and simplicity are what you are after then look no further. Uptime Kuma offers the sleekest of user interface experiences you will ever come across on a monitoring tool. It is modern, fancy, reactive and very responsive to your instructions.

Receive Notifications

You can receive notifications on the monitored services you have with over 95+ different channels. You can setup Email (SMTP) alerts, Telegram or Signal alerts, Slack Channel alerts, Discord notifications, Splunk, SendGrid, Twilio and even Pushover. Missing a notification for a service, network, app or website is now old school.

Host Multiple Status Pages

Uptime Kuma allows you to create multiple status pages for specific services or domains. Status pages allow you to set communications between you and your customers in an event of a health issue on your systems, current incidents, outages and any real-time information you can provide as an update.

API Keys

If you have a Prometheus Metrics Endpoint and would like to access it you can do so in Uptime Kuma with the use of API keys. By default API keys are not used and only basic HTTP authentication method is used for securing access to the Prometheus metrics endpoint. Once an API key is added the basic HTTP authentication method is disabled.

Multi-Language support

Do you know what would be helpful? Having a network or web monitoring tool in your preferred language. Uptime Kuma is available in over 20+ languages such as English, French, German, Irish, Japanese and Portuguese. It is still being translated to more languages.

Strong Security

Let’s be real for a minute, no one wants their most critical networks, websites, apps or backends being compromised right at a very core component of the infrastructure and servers? Right. Uptime Kuma supports two-factor authentication requiring two forms of identification so it can ask for two forms of access IDs to allow you to login.

Dark and Light Mode

Dark mode lovers, you need to be here. Uptime Kuma offers a beautiful dark mode and light mode interface which you can toggle to Light, Dark and Auto and it will change based on what it can detect on your system theme. You can now treat your eyes to beautiful ping charts in dark mode.

Proxy Support

We know you are not always at your desk at home office and even some tools have to be accessed remotely to help mitigate or investigate an outage or downtime. With Uptime Kuma, you can setup a proxy and access it over the public internet with popular services like Cloudflare, Caddy, HAProxy, Traefik, Apache and Nginx.

Getting Started

Learn how to get started with Uptime Kuma once you have downloaded it. There are multiple ways you can follow to Install Uptime Kuma on your server. We have guides covering Docker, Linux and Windows Server below. Follow the guide that best fits your requirements and OS.

Recommended

Install with Docker Compose

One compose file, one volume. Moving to a new release is a pull and a restart, and rolling back is just as quick.

About 5 min · any Linux host, NAS, or Windows with WSL2

Install on Linux without Docker

Node.js and a systemd service straight on the box. Worth it if you already manage the host with Ansible or want it behind an existing reverse proxy.

About 15 min · Ubuntu, Debian, Rocky, Arch

Install on Windows

For Windows 10 x64 and Windows Server. We cover running it as a background service so it survives a reboot rather than a logout.

About 15 min · Windows 10 x64, Server 2012 R2+

Helpful Guides

Start configuring and actually getting use out of your Uptime Kuma instance now. Follow the guides below to add your first monitor, create a status page, reset the login password or export your metrics to Grafana.

Add your first monitor

What each monitor type is for, and how to set retries and intervals so you get alerted about real outages instead of your own Wi-Fi.

Create a free status page

Group monitors, post incidents and point a custom domain at it without exposing your admin dashboard to the internet.

Reset a lost Uptime Kuma password

Recover access from the CLI, including clearing 2FA when the authenticator app is gone. Our most-read page, for obvious reasons.

Connect Uptime Kuma to Grafana

Scrape the Prometheus endpoint with an API key and put your heartbeats on a dashboard next to everything else you already graph.

Uptime Kuma alternatives compared

Where Uptime Kuma beats the hosted options and the other self-hosted checkers and the places it honestly doesn’t.

Browse the Uptime Kuma wiki

This is the user documentation area and it includes troubleshooting, configuration and optimisation walkthroughs.

Screenshots

See Uptime Kuma in action with the different pages and how the monitoring dashboard looks.

Uptime Kuma Monitoring Dashboard Overview

Powered by Modern Technologies

Built with open-source and modern programming languages such as TypeScript, JavaScript, Vue.js and Go, you do not have to worry about stability and support.

Uptime Kuma is the ultimate choice of monitoring tool when it comes to monitoring your network or servers. It offers features such as:

Monitor HTTP/HTTPS domains, and keywords on webpages, monitor your DNS records, Docker Containers and even databases such as MySQL and SQL.
A beautiful, reactive and fast user interface that is easy on the eyes and not a mission to navigate around.
Dark mode support for those who do not like a bright interface. It can also be set to automatically adapt to your system settings.
If you love graphs and charts, Uptime Kuma has them all! You have beautiful Ping charts that can show you uptime and monitoring information along with time.
Get notified when an alert fires off with one of your services being down. You can receive alert notifications to any favorite apps you may have including Slack, Telegram, Discord, SendGrid, OpsGenie and PagerDuty.
Support for using Uptime Kuma with your own proxy if you are not on your local network or away from home.
With 20-second intervals, you can never miss a downtime event on your servers, infrastructure or network. These can be modified and set higher than 20 seconds as well.
Want Uptime Kuma in your own language? Not a problem. With official support for 20+ languages, there is a high chance it is available in your local language.
If you have customers who may need a notification when a service is down, you can create your own status pages and notify them of any maintenance periods.
Keep a close eye on your SSL certificates if you have one or multiple installed on your websites or servers before they expire.
Secure our monitoring instance dashboard behind a 2FA login page. Manage your users and secure their access to Uptime Kuma.

Minimum CPU: 1 vCPU

Recommended CPU: 2 vCPU

Minimum RAM: 1 GB

Recommended RAM: 2 GB

Storage space: 20 GB (The more log history you store, the more storage is required)

Host OS: Ubuntu, Debian, Rocky Linux, ArchLinux, CentOS, Windows 10 (X64), Windows Server 2012 R2 and above

Note: System requirements for Uptime Kuma vary a lot on how it is used and the number of monitoring probes you have set up. The resources needed also vary on how it is run e.g. If it is directly installed on the server or if it is running as a container using Docker.

The above requirements have been tested with a setup that had 25 probes of various endpoints including IP addresses, Websites, Ports and Databases. The more probes you monitor, the more resources you will need to host Uptime Kuma.

Would you like to try a live demo?

You can launch your own Uptime Kuma instance so you can see how it works, get comfortable with the interface and what it has to offer. All data gets deleted automatically after 10 minutes.

demo.kuma.pet/start-demo

Frequently Asked Questions

Below is a comprehensive collection of questions that are frequently asked by our users. We hope these answer any concerns or queries you may have regarding using this monitoring tool from simple to more complex troubleshooting asks.

What is Uptime Kuma?

Uptime Kuma is a monitoring tool that allows anyone to monitor any web services such HTTP/HTTPS websites, Apps, TCP Ports, SSL certificates and even MySQL databases.

Is Uptime Kuma Free?

Uptime Kuma is fully open-source, this means that the codebase and all files are free for anyone to download and use. You do not need to pay any amount to use it. However, if you are going to host it on a server in the Public Cloud, you will have to pay the actual costs of the server.

Is Uptime Kuma Safe and Secure to Use?

The monitoring tool itself is secure and safe to use, there are thousands of users around the world using Uptime Kuma without a problem. However, it is up to you to secure the hosting environment from security issues where you have it installed and configured.

Uptime Kuma Reports service being “Down” but it isn’t.

When you get a “Down” alert but are still able to access the service, this usually means that there is a local problem on the network most likely to a misconfiguration in your networking. Check your Firewall or Network Ports for any recent changes.

To debug any Docker container specific issues and if there is no connectivity you can SSH into your container and use tools like “curl, ping or iptables” to check if it has outside connectivity and can reach the public internet.

How is Uptime Kuma Licensed?

Uptime Kuma is licensed under the “MIT License“.

What can Uptime Kuma be used for?

Uptime Kuma is primarily used only for monitoring services and infrastructure. It has a broad range of support for different protocols and services such as HTTP/HTTPS, TCP, SSL Certificates, IP Addresses, ICMP Ping and database monitoring. You can use it for something at a hobby-level for monitoring home server projects or even monitor the infrastructure of your business.

Is Uptime Kuma the same as Grafana?

Uptime Kuma has a more direct focus on providing features to monitor a wide variety of network endpoints. Grafana provides the ability visualise data from sources such as Graphite, Prometheus, VictoriaMetrics into beautiful graphs and dashboards that are highly customizable according to your needs.

What is the default Uptime Kuma Login?

The default password of Uptime Kuma is just “Password”. However you can reset the admin password via the CLI if you have access to the server. It is highly advisable to always choose a strong password. Uptime Kuma does not have a default login and password.

Does Uptime Kuma work with Docker and Docker Compose?

You can use both Docker and Docker Compose to deploy Uptime Kuma. It is a method we recommend to deploy as it is the easiest, quickest and most intuitive method of deploying and making changes to this monitoring tool.

How many endpoints or websites can I monitor?

You can monitor any number of endpoints or monitors as you wish. What you may keep in mind is the hardware specifications of where Uptime Kuma is hosted as monitoring a large number of endpoints will add to CPU and Memory usage depending on your use cases.

What is the default port for Uptime Kuma?

Configuring Uptime Kuma with default settings will set its default port to listen on “3001”. However, you are free to choose any port number you wish during the installation process.

Does Uptime Kuma work with Home Assistant?

Home Assistant is an open-source home automation dashboard where you can monitor your smart devices and energy use. You can add Uptime Kuma directly to your Home Assistant setup by installing it as an add-on.

Is there an Uptime Kuma Android or iOS App?

There are currently no official Uptime Kuma mobile applications developed for Android or iOS. Please refrain from downloading unofficial apps as you risk your data being leaked or misused. However, you can still access the Uptime Kuma dashboard on your mobile phone as it is mobile-friendly.

Can Uptime Kuma monitor LLMs?

Uptime Kuma can monitor something like llama.cpp but only as a generic service endpoint. If llama.cpp is running, let’s say in a server mode exposing an HTTP API then it can monitor /health or /completion. However, it does not understand LLMs specifically and is not an LLM monitoring tool.

Are Uptime Kuma and UptimeRobot the same?

Uptime Kuma and UptimeRobot are both different monitoring tools. They are not the same. The major difference separating the both is that Uptime Kuma is open-source and free for all its features including unlimited monitors. Whereas UptimeRobot limits its “free” tier to only 50 monitors and a basic status page.

Is there an Uptime Kuma Helm Chart available?

A Helm Chart is a package that includes all resources so you can also deploy it onto a Kubernetes environment usually a cluster setup. Uptime Kuma does not have an official Helm Chart repository but you can use the following created by a user that also works. Instructions can be found here.