Kuma is a monitoring tool that we can install on our server. That’s why in this tutorial I will help you how to install Kuma on Ubuntu 20.04.
What is Kuma?
According to the official Kuma Documentation
Kuma is a platform-agnostic open-source control plane for service mesh and microservices management, with support for Kubernetes, VM, and bare-metal environments.
So we have an idea that with it we will be able to monitor services through a comfortable and dedicated web interface. Being ‘Agnosctic’ we can install it on any operating system that supports NodeJS and take full advantage of it without any problem.
Some of the main features of Kuma are:
- Monitoring uptime for HTTP(s) / TCP / HTTP(s) Keyword / Ping / DNS Record / Push / Steam Game Server.
- Fancy, Reactive, Fast UI/UX.
- Notifications via Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP), and more.
- Simple Status Page
- Ping Chart
In addition to this, it has an alternative installation via Docker, so the installation becomes completely universal.
Install Kuma on Ubuntu
Before we start we have to meet some requirements on the server such as having it updated and installing a recent version of NodeJS.
Step 1: Install NodeJS on Ubuntu
The application is written in NodeJS so we have to install it as a requirement before the application. So, first, update the system to install the released security patches to improve the system behavior.
sudo apt update sudo apt upgrade
After this, we have to install NodeJS but not just any version but one of the recent ones. To do this, add the repository of the
17x. branch as follows
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
This script will add the repository to the system and refresh APT automatically. So to install NodeJS you just need to run
sudo apt install nodejs
This way, we will already have NodeJS installed on the system.
Step 2: Install Git on Ubuntu
To install Kuma, we need to clone its Github repository and for that, we need
git. For Linux, we have several different methods, but in this case, the version included in the official repositories is enough.
So, install git using
sudo apt install git
git and NodeJS installed, we can continue.
Step 3: Install Kuma on Ubuntu
With the help of
git, you have to clone the Kuma repository. This ensures that we will have the latest stable version of the application as well as being a secure method of installation.
So, clone the repository and save it in a directory like
sudo git clone https://github.com/louislam/uptime-kuma.git /opt/uptime-kuma
This will generate a folder with the necessary files. Access it.
And finally, perform the installation of the dependencies as follows
sudo npm run setup
Normally we would treat Kuma as a system service. In this case, let’s create one
sudo nano /etc/systemd/system/uptime-kuma.service
And add the following
[Unit] Description=Uptime Kuma - uptime monitoring tool After=network.target [Service] WorkingDirectory=/opt/uptime-kuma ExecStart=/usr/bin/node server/server.js Restart=always [Install] WantedBy=multi-user.target
Save the changes and close the text editor. And to apply the new service configuration run
sudo systemctl daemon-reload
Start the service and enable it to start with the system in the following way
sudo systemctl enable --now uptime-kuma
Created symlink /etc/systemd/system/multi-user.target.wants/uptime-kuma.service → /etc/systemd/system/uptime-kuma.service.
And finally, you can check the status of the service as follows
sudo systemctl status uptime-kuma
So, in the image, you can see that the service is working properly.
Check the results by access to the Kuma interface
Now we will be able to access Kuma through a web browser of our preference. So, open it and go to
http://your-server:3001 to see the admin user creation screen.
In this screen, choose the language to display, and a username of the admin user along with its password.
When you are ready you can click on the Create button.
And you will see the main screen of Uptime Kuma.
Now it’s your turn to make the most of it,
Kuma is a vital tool for many sysadmin because it monitors many services and is fully compatible with Kubernetes so the utility becomes even greater. It can be installed on many different operating systems quickly and easily. The important thing is that it is another open-source alternative for the professional world helping to spread even more to our system.
So, share our posts through your networks and help us to grow. Thank you.