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

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

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, 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.
  • 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
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

Install Kuvasz on Unraid in a few clicks.

Find Kuvasz in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Kuvasz Review the template variables and paths Click Install

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

43,886
Total Downloads
9,024
This Month
4,058
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
kuvaszmonitoring/kuvasz:latest
Last Updated2026-07-20
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