Monitor Servers and Services with Uptime Kuma

Monitor Servers and Services with Uptime Kuma

In the realm of server management and website monitoring, staying informed about the status and health of your servers and services is paramount. Enter Uptime Kuma, an emerging star in the world of open-source monitoring tools.

This blog post will explore what Uptime Kuma is, its key features, and why it’s becoming a go-to choice for IT professionals and web administrators.

Introduction to Uptime Kuma

Uptime Kuma is an open-source, self-hosted monitoring tool that comprehensively views the uptime, downtime, and response times of various internet services and servers.

It’s a powerful alternative to paid services like Uptime Robot, offering extensive customization, control, and privacy due to its self-hosted nature.

Key Features of Uptime Kuma

  1. Multi-Service Monitoring: Supports monitoring HTTP/S, TCP, HTTP(s) Keyword, Ping, DNS Record, Push, Steam Game Server, and more.
  2. Real-Time Updates: Provides real-time status updates for all monitored services.
  3. Alerts and Notifications: Integrates with popular notification services like Telegram, Discord, Gotify, Slack, Pushover, and email.
  4. Customizable Dashboard: Offers a user-friendly and customizable dashboard to view and manage the status of all services.
  5. Multi-Language Support: Available in multiple languages, making it accessible to a global user base.

What does it look like?

uptimekuma Monitor Servers and Services with Uptime Kuma

The screenshot shows Uptime Kuma’s dashboard on the author’s GitHub page.

Setting Up Uptime Kuma

Uptime Kuma’s setup process is straightforward:

  1. Installation: It can be installed on various platforms, including Docker, a popular choice for its ease of use and portability.
  2. Configuration: After installation, services and servers to be monitored are added to the dashboard. Each service can be configured with specific monitoring parameters.
  3. Notifications Setup: Configure notification channels to receive alerts about any status changes.

Benefits of Uptime Kuma

  • Cost-Effective: Being open-source, it is free, offering a cost-effective solution for startups and businesses.
  • Privacy and Security: Self-hosting means data stays within your control, enhancing privacy and security.
  • Flexibility and Customization: Offers great flexibility and customization options to cater to specific monitoring needs.
  • Active Community Support: Benefits from robust community support and regular updates.

Use Cases for Uptime Kuma

  • Website Monitoring: Ideal for webmasters and bloggers to keep track of their website’s uptime.
  • Server Health Monitoring: IT professionals use it to monitor server health and network status.
  • Business Operations: Businesses employ it to ensure critical services are always running for their customers.


Uptime Kuma is a shining example of the capabilities of open-source software in professional-grade server and service monitoring. It strikes an excellent balance between functionality, ease of use, and cost-effectiveness.

Whether you’re managing a single website or an array of servers, Uptime Kuma is a tool that can adapt to your needs, ensuring you’re always in the know about the status of your digital infrastructure.

Installing Uptime Kuma on Kubernetes

Installing Uptime Kuma on Kubernetes involves several steps, including setting up a deployment and service configuration. Here’s a general outline of the process:


  1. Kubernetes Cluster: Ensure you have a working Kubernetes cluster.
  2. kubectl: Have kubectl installed and configured to communicate with your cluster.
  3. Persistent Storage: Optionally, set up persistent storage if you want to retain data across pod restarts.

Steps to Install Uptime Kuma on Kubernetes

1. Create a Deployment Configuration

  • You need to create a Kubernetes deployment configuration for Uptime Kuma. This can be done by creating a YAML file. I created a file called ‘uptime-kuma-deployment.yaml'.
  • I defined the Uptime Kuma Docker image, ports, and other configurations in this file.

Here is an example of what the deployment file looks like:

apiVersion: apps/v1
kind: Deployment
  name: uptime-kuma
  replicas: 1
      app: uptime-kuma
       app: uptime-kuma
        - env:
            - name: UPTIME_KUMA_PORT
              value: "3001"
            - name: PORT
              value: "3001"
          image: louislam/uptime-kuma:1.23.3
          imagePullPolicy: Always
          name: uptime-kuma
            - name: uptime-kuma
              containerPort: 3001
              protocol: TCP
            - mountPath: /app/data
              name: vol-uptime-kuma
        - name: vol-uptime-kuma
            claimName: pvc-uptime-kuma
apiVersion: v1
kind: PersistentVolumeClaim
  name: pvc-uptime-kuma
    - ReadWriteOnce
  storageClassName: longhorn
      storage: 1Gi

Note that this yaml includes setting up a persistent volume claim on Longhorn to store the configuration data and this is mounted to the /app/data folder within the container.

2. Deploy to Kubernetes

I deployed the yaml file to Kubernetes with the following command: –

kubectl create -f uptime-kuma-deployment.yaml

3. Create a Service

  • To access Uptime Kuma externally, you must create a Kubernetes service.
  • I created another YAML file called ‘uptime-kuma-service.yaml', to define the service.

The contents of the file are: –

apiVersion: v1
kind: Service
  name: uptime-kuma-service
    app: uptime-kuma
  - name: uptime-kuma
    port: 3001

I applied this to Kubernetes with the following command: –

kubectl create -f uptime-kuma-service.yaml

4. Access Uptime Kuma

In other posts, I write about using Traefik as the ingress into my services. This is also the case with Uptime Kuma. I created a file called ‘ingressroute.yaml’ to contain this: –

kind: IngressRoute
  name: uptime-kuma
    - websecure
    - match: Host(``)
      kind: Rule
        - name: uptime-kuma-service
          port: 3001

Again, I deployed this to Kubernetes using the following command: –

kubectl create -f ingressroute.yaml

Final Notes

  • Version: Make sure to specify the correct version/tag of the Uptime Kuma Docker image.
  • Configuration: Adjust the configuration (like resource limits, number of replicas) according to your needs.
  • Security: Consider security aspects such as network policies, especially if deploying in a production environment.

This guide provides a general approach to deploying Uptime Kuma on Kubernetes. Depending on your specific Kubernetes setup and requirements, additional steps or modifications might be necessary.


Hi, my name is Stephen Finchett. I have been a software engineer for over 30 years and worked on complex, business critical, multi-user systems for all of my career. For the last 15 years, I have been concentrating on web based solutions using the Microsoft Stack including ASP.Net, C#, TypeScript, SQL Server and running everything at scale within Kubernetes.