# Checkcle for Monitoring Homelabs

**URL:** https://discussion.scottibyte.com/t/checkcle-for-monitoring-homelabs/632
**Category:** Uncategorized
**Created:** [May 30, 2025, 3:28am UTC](https://discussion.scottibyte.com/t/checkcle-for-monitoring-homelabs/632 "2025-05-30T03:28:57Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![scott](https://discussion.scottibyte.com/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@scott](https://discussion.scottibyte.com/u/scott)
#### Post date: [May 30, 2025, 3:28am UTC](https://discussion.scottibyte.com/t/checkcle-for-monitoring-homelabs/632/1 "2025-05-30T03:28:57Z")

</div>

In July 2024, I presented [Home Lab Network Monitoring](https://www.youtube.com/watch?v=0DryhzrQSJA) where I discussed NetAlertX, Apprise, and Gotify for monitoring and reporting on changes to your Homelab service environment.

Many folks use UpTimeKuma to perform this function more easily. Today, I am discussing “Checkcle” which is an application to monitor your Homelab service status and to notify you when services are down or your SSL certificates have problems.

[Checkcle](https://github.com/operacle/checkcle) provides a means to monitor services via http/https, ping, TCP and DNS. Checkcle can also monitor the status of your SSL certificates and their expiration dates. This application is in the early stage of development, but seems very promising in terms of delivering an easy to use interface with a more modern look and feel than UpTimeKuma.

Checkcle can also track your schedules for your application maintenance windows if you so desire.

Checkcle has a polished & also simple user interface.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/7/7c4066bde464eebec8c4e38deacfdf9491d8d854.jpeg)

As of this presentation in the end of May, 2025 checkcle can monitor your home lab services and SSL certificates/Domain names. The application also has a working option to perform schedule and incident reporting for maintenance and downtime.

I found that the “Instance Monitoring”, “Operational Page”, “Reports” and “API Documentation” appear to be in-work, but not yet operational in my testing.

You can create a new service to be monitored by clicking the “New Service” button and you fill in the form.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/5/55ff724462051cbfd60d29db9ff9453dffa0a2b0.png)

The options for the service types are:

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/8/86d5cb98222e53ded188d6b20fcc8cb1172966da.png)

Monitoring services with checkcle is similar to the functionality you get with UpTimeKuma.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/e/e6164c3ccc0478ebd88249e52ce42d8c0be691a8.jpeg)

In the SSL & Domains section, you can “Add Domain” and it can monitor the availability of an SSL certificate and DNS entry.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/1/16a40c780cfa8096e87cba551ee54a13a5ed4a4a.png)

In my case, [scottibyte.com](http://scottibyte.com) is a valid domain, but the certificate that I have for it is expired because I do not use it directly. In the video, I add [chat.scottibyte.com](http://chat.scottibyte.com) for my RocketChat server (which you should join) and it shows that it is valid and expires in 65 days.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/d/d833ba7e6a684a30782d79bc200b6d7996a7d408.jpeg)

The schedules & Incident section is designed to document your maintenance schedule and other operational cycles that affect your applcations.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/f/f4272d33cf88f6dc40f6369596817be62aeaae01.jpeg)

Of special note are the notification settings in the setting panel.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/1/1b30bf7ad71449a623b04e503100e30c8f899fc4.jpeg)

As I mentioned in the video, I would have preferred to see “Apprise” as a self-hosted notifer providing access to 60+ notification engines and I hope that’s a future. For now, notifications appear to be limited to Telegram, Discord, Slack, Signal and Email.

I personally like Gotify and Ntfy.

As of this writing, Checkcle is at v1.2.0.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/0/08e1805916af749ee268c6be6b0a4a60b9761348.jpeg)

You can read the complete documentation for checkcle [here](https://docs.checkcle.io).

I am installing checkcle as a docker application nested in an incus container. If you followed my “Incus Containers Step by Step” tutorial, then you will have the bridgeprofile. Create the incus container for checkcle:

```auto
incus launch images:ubuntu/24.04 Checkcle -p default -p bridgeprofile -c boot.autostart=true -c security.nesting=true 

```

Connect to the root account in the container.

```auto
incus shell Checkcle

```

Take all of the updates.

```auto
apt update && apt upgrade -y

```

Install some dependencies.

```auto
apt install curl net-tools nano openssh-server -y

```

Install docker from the script on the docker website.

```auto
curl -sSL https://get.docker.com | sh

```

Add a username and put the user in the sudo and docker groups.

```auto
adduser scott
usermod -aG sudo scott
usermod -aG docker scott

```

Move over to the new user account.

```auto
su - scott

```

Create a folder for the application and move inside of it.

```auto
mkdir checkcle
cd checkcle

```

Edit a file for the docker compose code:

```auto
nano compose.yml

```

Insert the following in the file as shown in the video.

```auto
services:
  checkcle:
    image: operacle/checkcle:latest
    container_name: checkcle
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - ./pb_data:/mnt/pb_data  
    ulimits:
      nofile:
        soft: 4096
        hard: 8192

```

Do a CTRL O and enter to save the file and a CTRL X to exit the nano editor.

Start up the application.

```auto
docker compose up -d

```

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/0/0cafb7ae586be6c9ead2491b8ef4e1873082ae4d.jpeg)

Once the application starts. Look for the address for eth0 which is the name of the network device inside the incus container. Your address will differ from mine.

```auto
ifconfig

```

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/c/cdddfc015baacae36a9931b1477f5d0be6231253.jpeg)

Go to your web browser and enter the address for eth0 that you just found and enter it with a :8090 at the end of the address and you should see the login screen for chackcle.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/d/d25316c785d2125f2c17563aedf40e549df71607.png)

Your initial username is [admin@example.com](mailto:admin@example.com) and your initial password is Admin123456.

After you initially sign in, go to the upper right hand corner of the web interface and click on the “S” and select “profile”.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/4/4257d0f58f28d1e94e377deaa5f0c832ab086a18.png)

Change the full name, username, and email and then click Save Changes which will log you out.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/5/5b238efb8e66cd40d67401eb435aceccc8180355.jpeg)

This time when you login, use the email you entered, but the password Admin123456 is still the same.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/7/70460d01b189a68a3a9c4c533ccb5e211fa4b688.png)

This time when you log back in, go to the “Security” option under your profile and change your password to your desired password. Keep in mind the old password is still “Admiin123456” at this point. Then click “Change Password”.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/1/1f4efc57d65e3da0345a986b3c838acffe3fb58e.jpeg)

You will be logged out again and now you can use your email and whatever new password you chose.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/1/17e4e9179a45f5a5b82abbb314ab9699f5504891.png)

Once you log back in go to the icon from which you chose “profile” and this time choose “settings”.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/d/dbd8281aabec9d7fa45ed48c02da6a28f3d24014.png)

Under the “System Settings” tab you will need to click “edit”

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/d/d074d9a032d1fb9aaedaf79e3a92dedff97a8f25.jpeg)

You will want to change your “Application URL” to match the address of your container as shown below.

 ![image](https://discussion.scottibyte.com/uploads/default/original/2X/7/72d3f25df948e46bee5d2a71b9c630a6848781ff.jpeg)

If you are publicly serving checkcle via a registered subdomain name, using NginX Proxy Manager, you would put the “https://” address in this field instead.

Finally, click “Save Changes”.

I tried changing the “Application Name” in the video and although I could make the change, I didn’t see the new name used in either the web GUI or the web browser tab as I would have expected. This is probably a bug that will be addressed soon.

At this point, you can add new services that you want to monitor as well as SSL & Domain names/certificates that you want to track.

It looks to me that this has the makings of a very powerful utility for the home lab that is easy to use.