Uptime Kuma is a modern, open-source monitoring tool that provides real-time uptime tracking for servers, websites, and services. Its user-friendly interface, detailed reporting, and customizable notifications make it an excellent alternative to hosted solutions like Uptime Robot. Hosting Uptime Kuma in your home lab offers full control and privacy, tailored to your monitoring needs.
Deploying Uptime Kuma with Docker ensures a quick, efficient, and isolated setup. Below is the docker-compose.yml file configuration:
services:
uptime-kuma:
image: louislam/uptime-kuma:latest
container_name: uptime-kuma
restart: always
ports:
- "3001:3001" # Adjust the host port if necessary
volumes:
- /home/josh/uptime-kuma/data:/app/data # Persistent data storage
environment:
TZ: "America/Las_Vegas" # Set your local timezone
Image:
louislam/uptime-kuma:latest image ensures deployment of the latest version of Uptime Kuma, complete with updates and security patches.Container Name:
uptime-kuma simplifies management and debugging.Restart Policy:
restart: always directive automatically restarts the service after failures or system reboots, ensuring reliability.Ports:
3001 on the host machine to the same port in the container, making the service accessible at http://<your-server-ip>:3001.Volumes:
/home/josh/uptime-kuma/data on the host, ensuring monitoring history and configurations are preserved.Environment Variables:
"America/Las_Vegas" timezone, aligning notifications and logs with local time.Prepare the Host Environment:
mkdir -p /home/josh/uptime-kuma/data
Deploy Uptime Kuma:
docker-compose up -d
Access the Uptime Kuma Dashboard:
http://<your-server-ip>:3001
Configure Monitors:
Ease of Deployment:
Persistent Data:
Scalability:
Custom Notifications:
Service Not Accessible:
docker ps
docker logs uptime-kuma
Port Conflicts:
3001 is already in use, modify the ports configuration:ports:
- "custom-port:3001"
docker-compose up -d
This Docker Compose setup provides a robust and reliable foundation for monitoring your home lab's uptime and status. With its real-time insights, customizable alerts, and modern design, Uptime Kuma ensures your systems remain operational and your services run smoothly. 🚀