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, 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.
  • 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
Pagerduty
Webhook
MS Teams ✅**
SMS / Voice call ✅** 10 incl./month
Google Chat, Pushover ✅**
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

34,862
Total Downloads
2,150
This Month
3,127
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

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