How To Install Uptime Kuma On Ubuntu 22.04 LTS Jammy

Steps to install Uptime Kuma open source monitoring solution on Ubuntu 22.04 LTS Jammy JellyFish without Docker to keep an eye on your server.

Kuma is a very lightweight monitoring tool for your own environment and many others. ICMP (ping) requests can be sent very easily or just check if a website is reachable. Even open TCP ports can be included in monitoring very easily. It is a self-hosted monitoring tool like “Uptime Robot”.

Here are its important features:

Uptime monitoring for HTTP(s) / TCP / HTTP(s) Keyword / Ping / DNS Record / Push / Steam Game Server.
Sophisticated, responsive and fast UI/UX.
Notifications via Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP) and 90+ notification services.
20 second intervals.
Multi languages
Multiple status pages
Map status page to domain
Ping graph
Certificate Information
Proxy support
2FA available

Steps to Install Kuma on Ubuntu 22.04 Linux

The commands given here to install Kuma can be used by other versions of Ubuntu servers or desktops such as 20.04 or 18.04 including Debian.

1. Update your Ubuntu 22.04

If you haven’t updated your Ubuntu 22.04 LTS Jammy for a while, run the given command first to make sure that all the packages in your system are in their latest version.

sudo apt update && sudo apt upgrade

2. Install Nodejs and NPM

The long-term stable version of Nodejs is already available to install using the APT package manager of our Ubuntu 22.04 system. However, the version we will get will be Nodejs v12 (quite old) and to install Uptime Kuma we need at least version 14. Therefore, manually add Nodejs repository to get its current version.

curl -fsSL | sudo -E bash -
sudo apt-get install -y nodejs

3. Install Uptime Kuma on Ubuntu 22.04

Kuma is not available to install using Ubuntu’s default system repository, so we need to clone it from the GitHub page where the project is located.

Install Git:

sudo apt install git

Clone Uptime Kuma Project

git clone

Proceed to clone the Kuma directory:

cd uptime-kuma

Now run its installation configuration using Nodejs NPM package manager.

npm run setup

4. Start Uptime Kumar with Pm2

PM2 is a production process manager for Node.js applications with an integrated load balancer. The main reason for installing and using Pm2 here is that it can manage and maintain the installed Nodejs application in the background. Thus, the Nodejs command line will be free to work on other applications. It also helps to monitor the status of installed applications.

Install PM2

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

Run Uptime Kumar server in background using PM2

start the server

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

After starting the server, let’s create a service file for PM2 so that it can automatically start the Kuma with our boot system.

pm2 startup

The above command checks the init system type and provides you with a command to create the pm2 service unit. Copy the script command given by the PM2 and throw it on your system. To get an idea, see the screenshot below:

5. Configure Proxy Server on Ubuntu 22.04 (Optional)

We can access the web interface of Uptime Kuma by opening the browser on our local system where we have installed it. Pointing it to Server IP address and using the port number 3001 because by default Kuma runs on this port.


Howeverif you want to use the reverse proxy server, here are the commands to do so.

For Nginx

Those who want to use Nginx can opt for the following commands:

Create an Nginx server block or virtual host file for Kuma:

sudo nano /etc/nginx/sites-available/kuma

Now add the following lines:

server  {
    listen 80;
    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;

To note: If you plan to use a domain, remember to replace with the one you want to use.

Save the file by pressing CTRL+Othen Walk in key and finally exit the file using CTRL+X.

After activating the created configuration file, delete the default one:

sudo ln -s /etc/nginx/sites-available/kuma /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default

Restart Nginx:

sudo service nginx restart


For Apache

Install Apache web server

sudo apt install apache2

Activate a few required modules:

sudo a2enmod ssl proxy proxy_ajp proxy_wstunnel proxy_http rewrite deflate headers proxy_balancer proxy_connect proxy_html

Restart apache:

sudo systemctl restart apache2

Create a virtual host configuration file for Kuma:

sudo nano /etc/apache2/sites-available/kuma.conf

Paste the following lines:

<VirtualHost *:80>

  ProxyPass / http://localhost:3001/
  RewriteEngine on
  RewriteCond %{HTTP:Upgrade} websocket [NC]
  RewriteCond %{HTTP:Connection} upgrade [NC]
  RewriteRule ^/?(.*) "ws://localhost:3001/$1" [P,L]

To note: If you plan to use a domain, remember to replace with the one you want to use.

Disable the default Apache configuration:

sudo a2dissite 000-default.conf

Activate the one you created for Kuma:

sudo a2ensite kuma.conf

Reload Apache

sudo systemctl reload apache2

To have other web servers configured as reverse proxy serverusers can see the GithubGenericName dedicated to this.

6. Availability Kumar web interface

After using Nginx or Apache as a proxy server, you can access the Kuma web interface to configure it.

Kuma Github uptime kuma install linux

7. Let’s Encrypt SSL certificate

Those not using a third-party SSL provider or DNS manager such as Cloudflare can directly generate the SSL certificate for free using the Let’s encrypt for domain used for Uptime Kuma running on Ubuntu 22.04. Here is the command to follow:

sudo apt install certbot

For Nginx:

sudo apt-get install python-certbot-nginx
sudo certbot --nginx -d 

For Apache:

sudo apt install python3-certbot-apache
sudo certbot --apache -d

To note: Replace with the one you have.

Other Items:

Install Google Cloud SQL Proxy on Ubuntu 22.04 | 20.04
3 Ways to Install Nodejs & NPM on Ubuntu 22.04 LTS Jammy
How to Install Checkmk on Ubuntu 22.04 LTS Jammy…
How to Install MediaWiki on Ubuntu 22.04
How to Install ownCloud on Ubuntu 22.04

Source link

Steven L. Nielsen