App Store template
Kuvasz icon

Kuvasz

Kuvasz is an open-source, self-hosted uptime and SSL monitoring service with status pages.

Launch in your Sealos workspace.

SourceDeploy guide Website
Kuvasz template preview
Template previewFull screenshot
Template deployments
15 on Sealos
Deployment
Your own instance
Category
Monitoring

About this template

Overview

Kuvasz is an open-source, self-hosted uptime and SSL monitoring service with status pages. This template deploys Kuvasz with a Kubeblocks PostgreSQL database and a public HTTPS endpoint on Sealos Cloud.

From the documentation

Kuvasz monitors websites and services with HTTP, SSL, push, and ICMP checks. It provides a web dashboard, REST API, notification integrations, metrics exporters, and status pages for publishing service health.

How to deploy Kuvasz

  1. Choose Deploy now to start Kuvasz in your Sealos workspace.
  2. Review admin_user, admin_password, admin_api_key in the deployment form.
  3. Launch the template, then inspect the application status and resource cards in Canvas.

Resources to plan for

Start with the resources defined by the Kuvasz template. Review CPU, memory, persistent storage, and network allocations for every service in Canvas. Capacity needs depend on your data and workload; monitor usage as they grow.

Template configuration and setup

Access after deployment

Use the application URL or connection details shown in Canvas. Follow the deployment guide for first-time account setup or client configuration, and keep generated credentials available for that step.

Hosting and billing

Sealos monthly plans include compute, memory, storage, and traffic. Size your plan for all deployed services. Software licenses and external AI or API services may have separate terms and charges. Confirm the applicable plan and optional charges in Cost Center.

Compare Sealos resource plans
Read full documentationCollapse documentation

For current cloud charges, refer to Sealos plan pricing. Upstream documentation may reference earlier billing models.

Deploy and Host Kuvasz on Sealos

Kuvasz is an open-source, self-hosted uptime and SSL monitoring service with status pages. This template deploys Kuvasz with a Kubeblocks PostgreSQL database and a public HTTPS endpoint on Sealos Cloud.

Kuvasz Screenshot

About Hosting Kuvasz

Kuvasz monitors websites and services with HTTP, SSL, push, and ICMP checks. It provides a web dashboard, REST API, notification integrations, metrics exporters, and status pages for publishing service health.

This Sealos template runs the official Kuvasz container as a single web service on port 8080. Sealos provisions PostgreSQL postgresql-16.4.0, creates the kuvasz database, mounts /config/kuvasz.yml from a ConfigMap, and exposes the dashboard through an HTTPS Ingress.

Authentication is enabled by default. The template asks for an initial admin username, admin password, and API key, with secure generated defaults for the password and API key.

Common Use Cases

  • Website uptime monitoring: Track public websites and APIs with HTTP status checks.
  • SSL certificate monitoring: Detect invalid or expiring certificates before users are affected.
  • Status pages: Publish service availability for teams, customers, or internal systems.
  • API-driven monitoring: Create, update, and export monitors through the Kuvasz REST API.
  • Notification workflows: Connect email, Discord, Slack, Telegram, PagerDuty, and webhook alerts.

Dependencies for Kuvasz Hosting

The Sealos template includes the required runtime components: the Kuvasz container image, a PostgreSQL database, a database initialization Job, a ConfigMap for /config/kuvasz.yml, a Kubernetes Service, an Ingress, and a Sealos App entry.

Deployment Dependencies
Implementation Details

Architecture Components:

This template deploys the following services:

  • Kuvasz Web Service: Runs kuvaszmonitoring/kuvasz:3.11.0 on port 8080 and serves the dashboard, REST API, health endpoint, and monitoring scheduler.
  • PostgreSQL: Kubeblocks-managed PostgreSQL postgresql-16.4.0 stores monitors, events, status pages, integrations, and application metadata.
  • PostgreSQL Init Job: Creates the kuvasz database idempotently after PostgreSQL is ready.
  • ConfigMap: Mounts /config/kuvasz.yml for optional integrations, YAML-managed monitors, status pages, and SMTP settings.
  • Ingress and App Entry: Sealos exposes Kuvasz through an HTTPS domain and creates a dashboard entry for direct access.

Configuration:

The template configures:

  • DATABASE_HOST, DATABASE_PORT, DATABASE_USER, and DATABASE_PASSWORD from the Kubeblocks PostgreSQL connection Secret.
  • DATABASE_NAME=kuvasz for the application database.
  • ENABLE_AUTH=true with the configured admin username, password, and API key.
  • APP_LANGUAGE=en and TZ=UTC.

After deployment, log in to the web UI with the configured admin username and password. Use the configured API key in the X-API-KEY header or as a Bearer token for REST API calls.

License Information:

Kuvasz is distributed under the Apache License 2.0. This Sealos template is provided as deployment configuration for Kuvasz and keeps the upstream application license unchanged.

Why Deploy Kuvasz on Sealos?

Sealos is an AI-assisted Cloud Operating System built on Kubernetes that unifies application deployment, operations, and resource management. By deploying Kuvasz on Sealos, you get:

  • One-Click Deployment: Deploy Kuvasz, PostgreSQL, networking, and the dashboard entry from one template.
  • Kubernetes Foundation: Run on Kubernetes-backed scheduling, service discovery, health checks, and rolling updates.
  • Persistent Database Included: Keep monitors, incidents, and status page data across restarts.
  • Instant Public Access: Each deployment receives an HTTPS URL for the dashboard, API, and status pages.
  • Easy Customization: Adjust environment variables, resources, and mounted configuration through Canvas, AI dialog, or resource cards.
  • Pay-As-You-Go Resources: Start with a compact resource profile and scale when monitoring volume grows.

Deploy Kuvasz on Sealos and focus on service reliability operations.

Deployment Guide

  1. Open the Kuvasz template and click Deploy Now.
  2. Configure the admin username, admin password, and API key in the popup dialog. The generated defaults are suitable for a first deployment.
  3. Wait for deployment to complete, typically 2-3 minutes. After deployment, you will be redirected to the Canvas. For later changes, describe your requirements in the AI dialog or click the relevant resource cards to modify settings.
  4. Open the generated Kuvasz URL from the App entry.
  5. Log in with the configured admin username and password.
  6. Create your first monitor from the dashboard, or call the REST API with the configured X-API-KEY value.

Configuration

After deployment, you can configure Kuvasz through:

  • Kuvasz Web UI: Create HTTP, SSL, push, and ICMP monitors; manage status pages; and configure supported integrations.
  • REST API: Send requests with X-API-KEY: <your-api-key> to manage monitors and read stats.
  • ConfigMap: Edit /config/kuvasz.yml through the Canvas resource card for YAML-managed monitors, SMTP settings, integrations, and status pages.
  • Sealos AI Dialog: Describe environment, resource, or configuration changes and let AI apply updates.
  • Resource Cards: Click the Deployment, PostgreSQL, ConfigMap, Ingress, or Service cards in Canvas to inspect and adjust settings.

When monitors are defined in /config/kuvasz.yml, Kuvasz treats that YAML file as the source of truth for those monitor types. Use the web UI or API for day-to-day edits when the YAML file leaves monitor sections empty.

Scaling

To scale Kuvasz on Sealos:

  1. Open the Canvas for your Kuvasz deployment.
  2. Click the Kuvasz Deployment resource card.
  3. Increase CPU or memory when monitor count, check frequency, API traffic, or integrations require more capacity.
  4. Apply the change and wait for the pod to become ready.

The default template uses 50m CPU and 384Mi memory requests with 500m CPU and 512Mi memory limits for the Kuvasz container. PostgreSQL uses 50m CPU and 51Mi memory requests with 500m CPU and 512Mi memory limits.

Troubleshooting

The app opens the login page

This is the expected first screen for a fresh deployment. Log in with the admin username and password configured during deployment.

API requests return unauthorized

Pass the API key as X-API-KEY: <your-api-key> or Authorization: Bearer <your-api-key>. The health endpoint /api/v2/health is public.

Monitor changes appear read-only

Kuvasz enables read-only mode for monitor types that are managed through /config/kuvasz.yml. Remove YAML-managed monitor sections or edit the ConfigMap when you want YAML to remain the operational source.

Getting Help

Additional Resources

License

This Sealos template is provided under the repository's template license. Kuvasz itself is licensed under the Apache License 2.0.

From launch to everyday operations

Why deploy
on Sealos

A shorter path from an app you want to an app you can run. Sealos brings deployment and ongoing operations into one place.

  1. One-click deployment

    Start with a ready-made template. Review its configuration and launch from the Sealos console.

  2. Managed Kubernetes

    Run on managed infrastructure with built-in workload scheduling and recovery.

  3. Automatic HTTPS

    Give your application a public HTTPS endpoint with certificates managed for you.

  4. Persistent storage

    Keep application data on persistent volumes across container restarts.

  5. Room to grow

    Adjust CPU, memory, and replicas from the console as your workload changes.

One template. Connected resources.

You Get the Whole Stack

Sealos provisions the resources defined by your template and brings them together in your workspace.

  • App Service

    Container workloads with configurable CPU, memory, and replicas.

  • Public HTTPS URL

    An address for your app, with managed TLS certificates.

  • Database

    A database provisioned alongside your app when the template calls for one.

  • Persistent Volume

    Storage for the files and data your application needs to keep.

  • Environment Variables

    Application settings and secrets configured in one place.

  • Logs & Metrics

    Inspect container logs and resource usage from the console.

Resources and their configuration vary by template. Review the deployment form for this app’s exact setup.

Related templates

Explore more production-ready templates.

More