|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: "Meet Uptime Kuma, a Fancy Open Source Uptime Monitor for all your HomeLab Monitoring Needs" |
| 4 | +date: 2021-10-03 10:00:00 -0500 |
| 5 | +categories: self-hosted |
| 6 | +tags: homelab uptime-kuma self-hosted docker monitoring alerting open-source |
| 7 | +--- |
| 8 | + |
| 9 | +[](https://www.youtube.com/watch?v=r_A5NKkAqZM "Meet Uptime Kuma, a Fancy Open Source Uptime Monitor for all your HomeLab Monitoring Needs") |
| 10 | + |
| 11 | +You've spun up lots of self-hosted services in your HomeLab but you haven't set up monitoring and alerting yet. We'll be glad you waited because today well set up Uptime Kuma to do just that. Uptime Kuma is a self-hosted, open source, fancy uptime monitoring and alerting system. It can monitor HTTP, HTTP with keyword, TCP, Ping, and even DNS systems! |
| 12 | + |
| 13 | +[https://github.com/louislam/uptime-kuma](https://github.com/louislam/uptime-kuma) |
| 14 | + |
| 15 | +[Watch Video](https://www.youtube.com/watch?v=r_A5NKkAqZM) |
| 16 | + |
| 17 | +(see video description for links to gear, discord, and other ways to connect.) |
| 18 | + |
| 19 | +## Docker Setup |
| 20 | + |
| 21 | +See [this post](https://techno-tim.github.io/posts/docker-compose-install/) on how to install `docker` and `docker-compose` |
| 22 | + |
| 23 | +## Running the container |
| 24 | + |
| 25 | +If you're using Docker compose |
| 26 | + |
| 27 | +```bash |
| 28 | +mkdir uptime-kuma |
| 29 | +cd uptime-kuma |
| 30 | +touch docker-compose.yml |
| 31 | +nano docker-compose.yml # copy the contents from below |
| 32 | +mkdir data |
| 33 | +ls |
| 34 | +docker-compose up -d --force-recreate |
| 35 | +``` |
| 36 | + |
| 37 | +`docker-compose.yml` |
| 38 | + |
| 39 | +```yml |
| 40 | +--- |
| 41 | +version: "3.1" |
| 42 | + |
| 43 | +services: |
| 44 | + uptime-kuma: |
| 45 | + image: louislam/uptime-kuma:1 |
| 46 | + container_name: uptime-kuma |
| 47 | + volumes: |
| 48 | + - /home/serveradmin/docker_volumes/uptime-kuma/data:/app/data |
| 49 | + ports: |
| 50 | + - 3001:3001 |
| 51 | + restart: unless-stopped |
| 52 | + security_opt: |
| 53 | + - no-new-privileges:true |
| 54 | +``` |
| 55 | +
|
| 56 | +
|
| 57 | +If you're using Rancher, Portainer, Open Media Vault, Unraid, or anything else with a GUI, just copy and paste the environment variables, ports, and volumes from above into the form on the web page. |
0 commit comments