All apps · 0 apps
kuvasz
Docker app from waazaa's Repository
Overview
Readme
View on GitHub
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.

📖 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 | |||
| ✅ | ✅ | ✅ | |
| 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:
- starring the project on GitHub and on Docker Hub
- following us on X
- following us on Mastodon
☕️ 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:
... or by sponsoring the project on GitHub
Requirements
https://kuvasz-uptime.dev/setup/installation/
There is another variables, see doc:
https://kuvasz-uptime.dev/setup/configuration/#__tabbed_2_2
Categories
Download Statistics
Total Downloads Over Time
Related apps
Explore more like this
Explore allLinks
Details
kuvaszmonitoring/kuvasz:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8080]- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--restart=unless-stopped
Template configuration
- Target
- 8080
- Value
- 8080
- Value
- /mnt/user/appdata/kuvasz/config.yml
- Value
- postgres
- Value
- user
- Value
- password
- Value
- user
- Value
- password
- Value
- jkdsfdsfvezjfbdsjcndslvnkslkfdsfdsqbvkdsv