Ubuntu Tutorial: Uptime Kuma

0 - Introduction

If you have a lot of services in your homelab, and would like a way to know when they get offline, setup Uptime Kuma. With it’s pretty interface a great ammount of features, you can have both a pretty status page for your services, and notifications and emails for when one of your services goes down.

To follow this article make sure you have docker installed, you can find a tutorial on how to install it here.

1 - Install

Start by creating a folder for Uptime Kuma then, in it, create a file named ‘docker-compose.yml’:

mkdir uptimekuma
cd uptimekuma
nano docker-compose.yml

In the docker compose file, we forward port 3001 (Webpage) and create a volume for the app data:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:latest
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data

After saving the file, run the following command to start the container:

docker compose up -d

You can then go to ‘yourip:3001’ and you will be greeted with a user creation screen.

Choose your language, create your username and set a password:

After logging in you can then ‘Add New Monitor’, make pages and get all the status for your services.

Thanks for reading and stay tuned for more tech insights and tutorials. Until next time, and keep exploring the world of tech!