Install Uptime Kuma on Ubuntu 22.04 LTS

January 7, 2023

Install Uptime Kuma on Ubuntu 22.04 LTS

Kuma is a lightweight monitoring tool that can be used to monitor various aspects of your environment. It can send ICMP (ping) requests or check the accessibility of websites, and can also monitor open TCP ports. Unlike many other monitoring tools, Kuma is self-hosted, meaning that you install and run it on your own servers rather than using a cloud-based service. It is similar to the self-hosted monitoring tool “Uptime Robot. Uptime Kuma is a tool used to manage and monitor the communication between microservices in a distributed system. It can be installed on Ubuntu 22.04 to help improve the performance and reliability of your microservices, as well as make it easier to manage them. With built-in monitoring and alerting features, Kuma can also help you keep track of the health and performance of your microservices and identify any issues that may arise.

By installing Kuma on Ubuntu 22.04, you can take advantage of these benefits to better manage and monitor your microservices. Some of the benefits of using Kuma on Ubuntu 22.04 might include:

Improved performance and reliability: Kuma can improve the performance and reliability of your system by helping to ensure that your microservices communicate efficiently and effectively.

Easier management: Using Kuma’s centralized control plane can make it easier to manage your microservices, regardless of their location or deployment method.

Enhanced monitoring: Kuma has built-in monitoring and alerting features that can help you track the health and performance of your microservices and be notified of any issues that may occur.

Lets get started!

1. Update your Ubuntu 22.04

Before installing Kuma, it’s a good idea to run the following command to ensure that all the packages on your Ubuntu 22.04 LTS system are up to date:

sudo apt update && sudo apt upgrade

2. Install Nodejs and NPM

Although the long-term stable version of Node.js is available to install using the APT package manager on Ubuntu 22.04, the version provided (Node.js v12) is quite old. To install Uptime Kuma, you will need at least version 14. Therefore, you will need to manually add the Node.js repository to get the current version.

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt-get install -y nodejs

3. Install Uptime Kuma

Since Kuma is not available in the default system repository of Ubuntu, we will need to clone it from the GitHub page where the project is hosted.

Install Git:

sudo apt install git

Clone the Uptime Kuma project:

git clone https://github.com/louislam/uptime-kuma.git

Switch to clone Kuma directory:

cd uptime-kuma

Now, use the NPM package manager of Node.js to run the installation setup:

npm run setup

4. Start Uptime Kumar with Pm2

PM2 is a production process manager for Node.js applications that includes a built-in load balancer. One of the main reasons to install and use PM2 is that it can keep Node.js applications running in the background, freeing up the command line to work on other tasks. PM2 also allows you to monitor the status of your installed applications.

Install Pm2:

sudo npm install pm2 -g && pm2 install pm2-logrotate

Use PM2 to run the Uptime Kuma server in the background.

Start Server:

pm2 start server/server.js --name uptime-kuma

After starting the server, create a service file for PM2 so that it can automatically start Kuma when the system boots.

pm2 startup

6. Uptime Kumar Web interface

To access the web interface of Uptime Kuma, open a browser on the system where it is installed and navigate to the server’s IP address and port 3001 (the default port on which Kuma runs).