Monitor Self-Hosted Websites and Projects on Raspberry Pi With Uptime Kuma

Self-hosting websites and services on your Raspberry Pi is a great hobby and a way of moving beyond the predatory clutches of big tech. But monitoring your server and making sure that everything is working as it should be can be a headache.

Uptime Kuma is a self-hosted uptime monitor which tracks uptime on your sites and can send you a notification if there are any problems.

4

What Is Uptime Kuma, and Why Do You Need It?

The Raspberry Pi is the center of many home server setups, and with the right software, you may use it to replace centralized, proprietary services almost entirely.

You can run your ownRaspberry Pi mail server,read full news articles with FreshRSS,stream music and movies with Jellyfin, or run a full-on cloud-based office suite and automated backup service withNextcloud on Raspberry Pi. You can even use aRaspberry Pi as a complete restaurant management system.

a brown bear looking mean

It’s a fun hobby, and gives you a head start in the fight for your privacy. But occasionally your services will develop problems. These may be configuration issues, or you may need to restart individual services or containers.

If you don’t use a service every day, you may not notice there are problems as soon as they develop. With Uptime Kuma, you can see your servers at a glance, and immediately tell if they’re up, down, or developing problems.

uptime kuma dashboard

熊, transliterated into the Latin alphabet as ‘Kuma’, is the Japanese word for Bear

you may also configure Uptime Kuma to send you notifications using a variety of methods, so you’ll know instantly if you need to take action.

install uptime kuma using docker

How to Install Uptime Kuma on Raspberry Pi

The simplest way to install Uptime Kuma on Raspberry Pi is with Docker. If you don’t already have Docker on your Raspberry Pi, install it with:

Start and enable Docker with:

create a new monitor in uptime kuma

Add your user to the Docker group:

For the new group membership to take effect, log out and back in again.

Now Docker is installed and running, you’re able to install Uptime Kuma with:

Docker will download the necessary images and set up containers to run Uptime Kuma in isolation.

If you’d prefer to use Docker Compose to manage Uptime Kuma, you’re able to easilycreate a Docker Compose file from any running container with docker-autocompose.

Use Uptime Kuma to Monitor Your Sites and Services on Raspberry Pi

Once Uptime Kuma is up and running, open your web browser and navigate to:your-pi-local-ip-address:3001.

You’ll be prompted to create a username and password for the admin user, then click through to the main dashboard interface. Right now, there won’t be anything there, so clickAdd New Monitor.

you may choose from many different types of monitor for services on your Raspberry Pi, including multiple database types, Docker containers, Steam game servers, pings, and DNS services.

The most widely applicable type of monitor isHTTP(s). Most of your services will have a web interface, and whether you access your service using a domain name, a local domain, or IP address and port number, you’ll be able to use this option for the front end of most Raspberry Pi-based services.

Additionally, you’re able to use this option to monitor uptime for websites on the wider web—not just your own. Give your service aFriendly Name, then type in the URL.

By default, Uptime Kuma will check if your service is alive every 60 seconds. This seems sensible, but you can alter the value to whatever you want.

You may want to change the number of tries before the service is marked as down and a notification is sent. Network blips happen from time to time and often correct themselves.

Checkbox options include ignoring SSL/TLS errors and expired security certificate notifications. Somewhat strangely, you can also activateUpside Down Mode, which will alert you when a service or website is up and running.

To monitor a Docker container, you’ll need the container name or ID as well as the Docker host, while for database monitoring, you’ll need the database credentials

Set Up Notifications

If you plan on monitoring solely through the web interface, you’re able to stop now. However, you probably want Uptime Kuma to notify you of outages so that you can fix them as quickly as possible. Click on the greenSetup Notificationbutton, and choose from the epic 49-entry dropdown list. Practically all options are covered, with highlights including notifications via email, Discord, Signal, Telegram, and Microsoft Teams.

To set up a Telegram notification, for example, all you need is a Chat ID and a bot token. You can get a bot token from theTelegram BotFather.

From the Notifications setup dialog, you can apply the same notification method to all your current monitors.

TheDashboardbutton in the top right gives you an overview of your services, and clicking on an individual entry will show a graph of response time and recent issues. You’ll see 24-hour and 30-day uptime percentage, and if you use a certificate to secure your site, Uptime Kuma will even give you the expiry date!

Monitoring Service Uptime on Raspberry Pi Is Easy!

Uptime Kuma is exceptionally easy to deploy and keeps you in the know about how your various services are running.

If you use your Raspberry Pi to host a website for readers to visit, it’s just as important to make sure your pages are free of spelling mistakes, grammar, errors and broken links

It can be hard to keep on top of website maintenance, which is where tools like SiteInspector come in. Here’s how it can automatically scan your site.

Love fades, even for the best open-source darling.

You’re conveying the wrong meaning when you send these emojis.

Turn these settings on, and your iPhone will be so much better than before.

My iPhone does it all, but I still need my dumb phone.

Tor spoiled me forever.

Technology Explained

PC & Mobile