{"id":1885,"date":"2026-09-05T09:36:37","date_gmt":"2026-09-05T04:06:37","guid":{"rendered":"https:\/\/cpanelfree.com\/blog\/how-to-host-uptime-kuma-server-monitoring-docker-vps\/"},"modified":"2026-09-05T12:59:12","modified_gmt":"2026-09-05T07:29:12","slug":"how-to-host-uptime-kuma-server-monitoring-docker-vps","status":"publish","type":"post","link":"https:\/\/cpanelfree.com\/blog\/how-to-host-uptime-kuma-server-monitoring-docker-vps\/","title":{"rendered":"How to Self-Host Uptime Kuma Status Page & Server Monitoring on Ubuntu VPS"},"content":{"rendered":"

Why Relying on Paid Status Page Services Is Unnecessary<\/h2>\n

Maintaining high service availability requires continuous monitoring of your website endpoints, API gateways, database ports, and DNS resolvers. While commercial monitoring SaaS platforms (like Pingdom, Better Uptime, or Statuspage.io) charge $25 to $100+ monthly with strict monitor quantity limits, self-hosting your own monitoring portal gives you unlimited monitors, custom check intervals down to 20 seconds, and branded public status pages at zero recurring cost.<\/p>\n

Uptime Kuma<\/strong> is the leading open-source self-hosted monitoring tool. Featuring an intuitive visual interface, Uptime Kuma monitors HTTP\/HTTPS endpoints, TCP ports, ping latency, DNS records, Docker container daemons, and Steam game servers. It includes native multi-channel alerting to over 90+ notification services (Discord, Telegram, Slack, Webhooks, SMS, Email) and publishes beautiful, mobile-friendly public status pages for your users.<\/p>\n

In this technical tutorial, we will configure Uptime Kuma on Ubuntu 24.04\/22.04 LTS with Docker Compose, secure the web portal behind an Nginx reverse proxy with SSL, configure multi-channel alerts, and publish a branded public status page.<\/p>\n

Step 1: Installing Docker and Creating Project Directory<\/h2>\n
# Install Docker and prerequisite utilities\nsudo apt update && sudo apt install -y curl nginx certbot python3-certbot-nginx\n\ncurl -fsSL https:\/\/get.docker.com | sudo sh\nsudo systemctl enable --now docker\n\n# Create dedicated directory for Uptime Kuma\nsudo mkdir -p \/var\/www\/uptime-kuma\nsudo chown -R $USER:$USER \/var\/www\/uptime-kuma\ncd \/var\/www\/uptime-kuma<\/code><\/pre>\n
Step 2: Writing Production Docker Compose File<\/h2>\n
Create \/var\/www\/uptime-kuma\/docker-compose.yml<\/code>:<\/p>\n
services:\n  uptime-kuma:\n    image: louislam\/uptime-kuma:1\n    container_name: uptime_kuma\n    restart: always\n    ports:\n      - \"127.0.0.1:3001:3001\"\n    volumes:\n      - .\/data:\/app\/data\n    deploy:\n      resources:\n        limits:\n          memory: 256M\n\nvolumes:\n  kuma_data:<\/code><\/pre>\n
Launch the container in background daemon mode:<\/p>\n
docker compose up -d\ndocker compose ps<\/code><\/pre>\n
Step 3: Nginx Reverse Proxy with Real-Time WebSockets & SSL<\/h2>\n
Uptime Kuma relies on WebSockets for live status updates. Create \/etc\/nginx\/sites-available\/status.example.com<\/code>:<\/p>\n
server {\n    listen 80;\n    server_name status.example.com;\n\n    location \/ {\n        proxy_pass http:\/\/127.0.0.1:3001;\n        proxy_http_version 1.1;\n        proxy_set_header Upgrade $http_upgrade;\n        proxy_set_header Connection \"upgrade\";\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n    }\n}<\/code><\/pre>\n
Enable the site configuration and acquire a free Let’s Encrypt SSL certificate:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/status.example.com \/etc\/nginx\/sites-enabled\/\nsudo nginx -t && sudo systemctl reload nginx\nsudo certbot --nginx -d status.example.com<\/code><\/pre>\n
Step 4: Configuring Multi-Channel Notifications (Discord \/ Telegram)<\/h2>\n
Navigate to Settings > Notifications > Setup Notification<\/strong> in your Uptime Kuma dashboard:<\/p>\n