Skip to content

Uptime Kuma

Knowing when your services go down is a must, you have multiple options when it comes to this requirement either in the form of SaaS or self-hosted. In following on with the nature of this project a self-hosted instance will be deployed.

What is Uptime Kuma?

If you’re completely new to monitoring products Uptime Kuma is basically a self-hosted version of Uptime Robot (which is also a great tool) and is hosted in the cloud. Uptime Robot does also offer a limited free tier which should be more than enough for a home lab environment.

Requirements

  • You have an instance of Docker already deployed

Deploying in Docker

You can conver the docker run command from the github repo to a compose file manually or you can use the one below.

...
version: '3.8'
services:
uptime-kuma:
image: louislam/uptime-kuma:1
container_name: uptime-kuma
volumes:
- uptime-kuma:/app/data
ports:
- "3001:3001" # <Host Port>:<Container Port>
restart: always
volumes:
uptime-kuma:
...

You should save the above configuration file as docker-compose.yml.

You can run the command docker-compose up -d from your terminal window to spin up the instance.