Self-Host a Professional Status Page with Uptime Kuma and Cloudflare Tunnel
A detailed guide to deploying a self-hosted status page using Uptime Kuma and Cloudflare Tunnel for secure, professional system monitoring.
Image credit: Nile · Pixabay Content License
Introduction to Status Pages and Uptime Kuma
A status page is a critical tool for communicating the operational state of services, systems, or applications to end users. With Uptime Kuma, you can build a self-hosted status page featuring a modern interface, real-time monitoring, and support for various checks (HTTP, TCP, Ping, DNS, etc.). When combined with Cloudflare Tunnel, the status page can be securely accessed from the Internet without exposing a public IP or opening ports.
Prerequisites and Setup
- Cloud VPS or Dedicated Server (minimum 2GB RAM, 1 CPU)
- Operating System: Linux (Ubuntu 20.04/22.04 or Debian)
- Node.js 16+ and npm
- Cloudflare account (free or paid)
- Docker installed (optional)
Deploy Uptime Kuma on VPS
Uptime Kuma can be deployed easily via Docker. Use the following command to start the container:
docker run -d \
--name uptime-kuma \
-p 3001:3001 \
-v /uptime-kuma/data:/app/data \
--restart unless-stopped \
louislam/uptime-kuma:1
After the container starts, access http://your-server-ip:3001 to complete the initial setup.
Connect with Cloudflare Tunnel
To securely expose Uptime Kuma without opening ports, use Cloudflare Tunnel:
- Log in to Cloudflare Dashboard → select your domain → go to “Zero Trust” → “Tunnels”
- Create a new Tunnel, choose “Connect a service” → “Custom” → name it (e.g., uptime-kuma)
- Add a service → select “HTTP” → port 3001
- Download the configuration file and install the Cloudflare Tunnel agent on your VPS:
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
chmod +x cloudflared
sudo ./cloudflared tunnel create uptime-kuma
sudo ./cloudflared tunnel route dns uptime-kuma your-domain.com
Next, create a configuration file config.yml:
tunnel: uptime-kuma
credentials-file: /root/.cloudflared/uptime-kuma.json
ingress:
- hostname: uptime-kuma.your-domain.com
service: http://localhost:3001
- service: http_status:404
Run the tunnel:
sudo ./cloudflared tunnel run uptime-kuma
Now, the Uptime Kuma status page is accessible at https://uptime-kuma.your-domain.com — secure and private.
Verification and Testing
- Visit
https://uptime-kuma.your-domain.comto verify access. - Add services to monitor (HTTP, TCP, Ping, etc.) within Uptime Kuma.
- Set up alerts via email, Discord, or Slack if needed.
Troubleshooting
- Cannot access page: Check firewall rules (ufw, iptables) and ensure port 3001 is open.
- Cloudflare Tunnel error: Verify configuration file, permissions, and tunnel status in the Cloudflare dashboard.
- Uptime Kuma fails to start: Check Docker logs using
docker logs uptime-kuma.
References
High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache
Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.
VPS-4E
10% VAT included
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
