Skip to content

Kuvasz (pronounce as [ˈkuvɒs]) is an open-source uptime and SSL monitoring service, built in Kotlin on top of the awesome Micronaut framework

License

Notifications You must be signed in to change notification settings

kuvasz-uptime/kuvasz

Repository files navigation

Kuvasz

CI codecov FOSSA Status CodeFactor Latest Release Gitter DockerHub


ℹ️ What is Kuvasz?

Kuvasz is a headless uptime monitor service, which means that it is able to watch all of your precious websites and notifies you if something bad happens to them. It is built in Kotlin, on top of the awesome Micronaut framework. There are a lot of exciting, new features on the roadmap, you should check them out here.

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.

Features

  • Uptime & latency monitoring with a configurable interval
  • SSL certification monitoring (once a day)
  • Email notifications through SMTP
  • Slack notifications through webhoooks
  • Telegram notifications through the Bot API
  • PagerDuty integration with automatic incident resolution
  • Configurable data retention period

Future ideas 🚧

  • Regular Lighthouse audits for your websites

⚡️ Quick start guide

Requirements

  • You have a running PostgreSQL instance (Preferably 12+)

Starting Kuvasz

The quickest way to spin up an instance of Kuvasz is something like this:

docker run -p 8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASSWORD=ThisShouldBeVeryVerySecure \
-e DATABASE_HOST=127.0.0.1 \
-e DATABASE_PORT=5432 \
-e DATABASE_NAME=your_database \
-e DATABASE_USER=your_db_user \
-e DATABASE_PASSWORD=OhThisIsSoSecure \
-e JWT_SIGNATURE_SECRET=testSecretItsVeryVerySecretSecret \
kuvaszmonitoring/kuvasz:latest

At this point you shouldn't see any error in your logs, so you're able to create your first monitor with an API call. Please, take a look at the API section of the Wiki, to get familiar with the authentication method that Kuvasz provides. If you have a valid access token, then creating a monitor and scheduling an uptime check for it, is simple like that:

curl --location --request POST 'https://your.host:8080/monitors/' \
--header 'Authorization: Bearer YourAccessToken' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "my_first_monitor",
    "url": "https://website.to.check",
    "uptimeCheckInterval": 60
}'

You can read more about the monitor management in the dedicated section of the Wiki.

⛴ Deployment

Although the example above is simple, when you want to deploy Kuvasz to production you'll probably end up with a more mature tooling or configuration. You can find the available configuration properties here. If you are going to deploy Kuvasz with docker-compose or Kubernetes, you should take a look at the deployment related examples, or the Deployment section of the Wiki.

📚 Further reading

If you want to know more about the fundamentals of Kuvasz, head to the Events & Event handlers section!

⁉️ Do you have a question?

There is a dedicated room for Kuvasz on Gitter.

❤️ Sponsors

JetBrains

Thanks to JetBrains for supporting the development of Kuvasz with their Open Source License Program 🙏