How to Install Uptime Kuma on Void Linux

Uptime Kuma is an open-source, self-hosted monitoring tool that provides insights into the uptime and performance of websites, applications, and servers. In this tutorial, we will walk you through the steps to install Uptime Kuma on Void Linux.

Prerequisites

Before you start, make sure you have:

  • A system running Void Linux
  • A non-root user with sudo privileges

Step 1: Install Node.js

Uptime Kuma is built with Node.js, so we need to install Node.js on our system. Run the following command to install Node.js:

sudo xbps-install nodejs

Once Node.js is installed, verify the installation by running the following command:

node -v

The command should output the version number of Node.js installed on your system.

Step 2: Install and Configure MySQL

Uptime Kuma uses MySQL as its database. Run the following command to install MySQL:

sudo xbps-install mariadb

Once installed, start the MySQL service:

sudo systemctl start mariadb

Then, run the following command to secure your MySQL installation:

sudo mysql_secure_installation

Follow the on-screen prompts to set a root password, remove the anonymous user, disallow remote root login, and remove the test database.

Next, create a new MySQL user and a database for Uptime Kuma:

sudo mysql -u root -p

CREATE DATABASE uptimekuma;
CREATE USER 'uptimekuma'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON uptimekuma.* TO 'uptimekuma'@'localhost';
FLUSH PRIVILEGES;
exit

Make sure to replace yourpassword with a strong password.

Step 3: Install Uptime Kuma

Clone the Uptime Kuma repository from GitHub using the following command:

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

Change into the uptime-kuma directory:

cd uptime-kuma

Install the required Node.js packages:

npm install

Create a new .env file using the template:

cp .env.example .env

Edit the .env file to set the MySQL database connection details:

DB_HOST=localhost
DB_PORT=3306
DB_NAME=uptimekuma
DB_USER=uptimekuma
DB_PASS=yourpassword

Replace yourpassword with the password you set for the MySQL user.

Step 4: Start Uptime Kuma

To start Uptime Kuma, run the following command:

npm start

The command will start Uptime Kuma on port 3000. To access Uptime Kuma, open your web browser and navigate to:

http://localhost:3000

You should see the Uptime Kuma login screen. Enter the default credentials:

After logging in, you will be prompted to change the default password.

Conclusion

Congratulations! You have successfully installed and configured Uptime Kuma on your Void Linux system. You can now use Uptime Kuma to monitor your websites, applications, and servers. Happy monitoring!