kuvasz

kuvasz

Docker app from waazaa's Repository

Overview

Kuvasz [ˈkuvɒs], an open-source, self-hosted uptime & SSL monitoring service, designed to help you keep track of your websites and services. It provides a modern, user-friendly interface, a powerful REST API, and supports multiple notification channels like email, Discord, Slack, Telegram, and PagerDuty.

Kuvasz

GitHub sponsors Docker Pulls CI codecov GitHub known bugs no vibe coded FOSSA Status


Kuvasz [ˈkuvɒs] is an open-source, self-hosted uptime & SSL monitoring service with status pages, designed to help you keep track of your websites and services. It provides a modern, user-friendly interface, a powerful REST API + MCP server, maintenance windows and supports multiple notification channels like email, Discord, Slack (via a webhook or a bot), Telegram, Microsoft Teams, Apprise, Pushover, PagerDuty and custom webhooks.

Kuvasz

📖 Documentation

🛝 Live demo

You can try out Kuvasz on the dedicated demo instance under https://demo.kuvasz-uptime.dev

Use the following credentials to log in:

  • Username: demo
  • Password: secureDemoPassword

🔮 Roadmap

⚡️ Quick start guide

If you want to get started quickly, please refer to the Deployment guide in the documentation.

✨ Features

  • HTTP(S) monitoring: Monitor the availability and performance of your websites and services by sending HTTP(S) requests.
  • SSL certification monitoring: Automatically check the SSL certificates of your monitored services to ensure they are valid and not expired.
  • Heartbeat (push) monitoring: Monitor your cron jobs, backups, and other scheduled tasks in a push-based manner, getting alerted when an expected heartbeat doesn't arrive in time.
  • Ping (ICMP) monitoring: Check the reachability and latency of any host by sending ICMP echo requests (pings) to it.
  • TCP port monitoring: Check whether any TCP service — databases, SMTP, SSH, message brokers, and more — accepts connections, and track connect latency.
  • DNS monitoring: Check that a name resolves, assert on the returned records (A, MX, TXT, NS, and more) with exact, substring or regex matchers, verify the response code, and optionally get notified when the resolved records change behind your back.
  • Docker monitoring: Check whether your containers are actually running and healthy - including their healthchecks, exit codes and OOM kills - through the Docker daemon, locally or remotely (TLS and mutual TLS included), and optionally track their CPU and memory usage.
  • Checks through proxies: Route the checks of selected HTTP and TCP monitors through an HTTP or SOCKS5 proxy (with or without authentication), e.g. a corporate egress proxy, or a SOCKS5 proxy into a private network.
  • Notifications on a per-monitor basis: Configure different notification channels for each monitor, allowing you to tailor alerts to your specific needs.
  • Status pages: Create public or private status pages to keep your users or your own team informed about the status of your services.
  • Sleek UI: Kuvasz has a modern, responsive, and user-friendly interface that makes it easy to manage your monitors.
  • Full-fledged REST API: Manage your monitors, check their status, and more through a powerful API.
  • Metrics exporters: Export your metrics to OpenTelemetry and Prometheus for better observability and integration with your existing monitoring stack.
  • Home Assistant integration: With the official Home Assistant integration you can easily integrate your monitors into your smart home setup, create custom dashboards, and automate actions based on the status of your services.
  • MCP server: The MCP server allows you to leverage the capabilities of Kuvasz via AI assistants, enabling you to query monitor status, view incidents, and create or toggle monitors through natural language.
  • Maintenance windows: Schedule planned downtime so Kuvasz pauses the affected checks and suppresses false alerts — manually, on a recurring cron schedule, or as a one-off event.
  • More to come: Take a look at our Roadmap

🚀 Kuvasz vs. UptimeRobot

Kuvasz UptimeRobot Free UptimeRobot Solo
Price Free Free $84/year
Monitoring interval 5 seconds 5 minutes 60 seconds
Monitors limit unlimited 50 10
Location-specific monitoring ✅* ❌ ✅
Translations ✅ ❌ ❌
Custom data retention ✅ 3 months 12 months
REST API ✅ ✅ ✅
OIDC ✅ ❌ ❌
Prometheus & OpenTelemetry exporters ✅ ❌ ❌
Backups & YAML configuration ✅ ❌ ❌
Status pages ✅ only 1 only 3
Maintenance windows ✅ ❌ ✅
HTTPs monitoring
Keyword matching ✅ ✅ ✅
Header matching ✅ ❌ ❌
Slow response alerts ✅ ❌ ✅
Custom HTTP methods ✅ ❌ (HEAD only) ✅
Custom status matcher ✅ ❌ ✅
Custom headers ✅ ❌ ✅
Custom request body ✅ ❌ ✅
SSL monitoring ✅ ❌ ✅
Heartbeat (push) monitoring ✅ ❌ ✅
Ping (ICMP) monitoring ✅ ✅ ✅
TCP monitoring ✅ ✅ ✅
DNS monitoring ✅ ❌ ✅
Docker container monitoring ✅ ❌ ❌
Domain expiration monitoring ❌ ❌ ✅
Notifications
Email ✅ ✅ ✅
Discord ✅ ✅ ✅
Slack ✅ ❌ ✅
Telegram ✅ ❌ ✅
MS Teams ✅ ❌ ✅
Apprise ✅ ❌ ❌
Pushover ✅ ❌ ✅
PagerDuty ✅ ❌ ❌
Webhook ✅ ❌ ❌
SMS / Voice call ✅** ❌ 10 incl./month
Google Chat ✅** ✅ ✅
Mattermost ✅** ❌ ✅
Signal ✅** ❌ ❌

✅ Supported | ❌ Not supported | 📆 Planned

  • * You can deploy Kuvasz to multiple locations and monitor your services from those locations, but it does not support location-specific monitoring out of the box.
  • ** via custom webhooks

Where does the name come from?

Kuvasz (pronounce as [ˈkuvɒs]) is an ancient hungarian breed of livestock & guard dog. You can read more about them on Wikipedia.

📣 Don't miss out on the latest updates!

First and foremost, if you want to stay up-to-date with the latest news, features, and updates about Kuvasz, please consider:

☕️ Do you like it?

While Kuvasz is free and open-source, it still requires a lot of time and effort to maintain and develop. If you like it, please consider supporting the project by donating via Ko-fi:

ko-fi

... or by sponsoring the project on GitHub

Requirements

You must create /mnt/user/appdata/kuvasz/config.yml file regarding documentation:
https://kuvasz-uptime.dev/setup/installation/

There is another variables, see doc:
https://kuvasz-uptime.dev/setup/configuration/#__tabbed_2_2

Download Statistics

65,784
Total Downloads
12,653
This Month
6,757
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
kuvaszmonitoring/kuvasz:latest
Last Updated2026-10-02
First Seen2025-08-03

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

PORTPorttcp
Target
8080
Value
8080
/config/kuvasz.ymlPathrw
Value
/mnt/user/appdata/kuvasz/config.yml
DATABASE_HOSTVariable
Value
postgres
DATABASE_USERVariable
Value
user
DATABASE_PASSWORDVariable
Value
password
ADMIN_USERVariable
Value
user
ADMIN_PASSWORDVariable
Value
password
ADMIN_API_KEYVariable
Value
jkdsfdsfvezjfbdsjcndslvnkslkfdsfdsqbvkdsv