RamNode logo
    Sign UpLogin
    Monitoring Guide

    Deploy Uptime Kuma Monitoring

    Uptime Kuma is a self-hosted monitoring tool that provides a beautiful interface for tracking the uptime and performance of your websites, services, and APIs. Deploy it on RamNode's reliable VPS hosting to monitor your infrastructure with complete data ownership.

    Ubuntu 22.04+
    Uptime Kuma
    ⏱️ 10-15 minutes

    Prerequisites

    Before starting, ensure you have:

    Server Requirements

    • • RamNode VPS (1GB+ RAM)
    • • Ubuntu 22.04 or later
    • • Root or sudo access
    • • Domain name (optional)
    → View VPS Plans

    What You'll Monitor

    • • HTTP(s) websites
    • • TCP ports & services
    • • DNS queries
    • • Docker containers
    2

    Install Docker

    Install Docker if you haven't already:

    Install Docker
    curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable docker
sudo systemctl start docker

    ✅ Docker is now installed and running

    3

    Deploy Uptime Kuma

    Create a directory and deploy Uptime Kuma:

    Create Directory
    mkdir -p ~/uptime-kuma
cd ~/uptime-kuma
    Deploy with Docker
    docker run -d \
  --name uptime-kuma \
  --restart=always \
  -p 3001:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:1

    💡 Tip: Access your dashboard at http://YOUR_SERVER_IP:3001

    4

    Docker Compose Setup (Recommended)

    For easier management, create a docker-compose.yml file:

    Create docker-compose.yml
    version: '3.8'

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - ./uptime-kuma-data:/app/data
    environment:
      - PUID=1000
      - PGID=1000
    Start the Service
    docker-compose up -d
    View Logs
    docker-compose logs -f
    5

    Setup Nginx Reverse Proxy

    Access Uptime Kuma via a custom domain with Nginx:

    Install Nginx and Certbot
    sudo apt update
sudo apt install nginx certbot python3-certbot-nginx -y
    Create Nginx Configuration
    sudo nano /etc/nginx/sites-available/uptime-kuma
    Nginx Config File
    server {
    listen 80;
    server_name status.yourdomain.com;

    location / {
        proxy_pass http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
    Enable Site
    sudo ln -s /etc/nginx/sites-available/uptime-kuma /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
    6

    Get SSL Certificate

    Secure your installation with Let's Encrypt SSL:

    Get SSL Certificate
    sudo certbot --nginx -d status.yourdomain.com

    🔒 Your Uptime Kuma dashboard is now accessible via HTTPS!

    7

    Add Your First Monitor

    Set up your first monitoring target:

    Steps to Add a Monitor:

    1. 1️⃣ Log in to your Uptime Kuma dashboard
    2. 2️⃣ Click "Add New Monitor"
    3. 3️⃣ Choose monitor type (HTTP(s), TCP, Ping, etc.)
    4. 4️⃣ Enter your service URL or IP address
    5. 5️⃣ Configure check interval (default: 60 seconds)
    6. 6️⃣ Click "Save"

    💡 Monitor Types: HTTP(s), TCP Port, Ping, DNS, Docker Container, Steam Game Server, and more!

    8

    Setup Notifications

    Configure alerts for downtime events:

    Setting Up Notifications:

    1. 1️⃣ Go to Settings → Notifications
    2. 2️⃣ Click "Setup Notification"
    3. 3️⃣ Select provider (Telegram, Discord, Slack, Email, etc.)
    4. 4️⃣ Enter required credentials
    5. 5️⃣ Test the notification
    6. 6️⃣ Save and assign to monitors

    Popular Providers

    Telegram, Discord, Slack

    Email Support

    SMTP, SendGrid, Mailgun

    90+ Services

    Extensive integrations

    9

    Create Status Page

    Share service status with your users:

    Creating a Status Page:

    1. 1️⃣ Click "Status Pages" in the sidebar
    2. 2️⃣ Click "New Status Page"
    3. 3️⃣ Choose a slug (URL path)
    4. 4️⃣ Add monitors to display
    5. 5️⃣ Customize appearance and theme
    6. 6️⃣ Set visibility (Public/Private)
    7. 7️⃣ Save and share the URL

    🌐 Your status page is now live! Share it with your team and customers.

    10

    Backup and Restore

    Backup your monitoring data regularly:

    Backup Data Volume
    docker stop uptime-kuma
docker cp uptime-kuma:/app/data ./uptime-kuma-backup-$(date +%Y%m%d)
docker start uptime-kuma

    💡 Alternative: Use the built-in backup feature in Settings → Backup

    Restore from Backup:

    Restore Backup
    docker stop uptime-kuma
docker cp ./uptime-kuma-backup-YYYYMMDD uptime-kuma:/app/data
docker start uptime-kuma
    11

    Updating Uptime Kuma

    Keep your installation up to date:

    Update with Docker
    docker pull louislam/uptime-kuma:1
docker stop uptime-kuma
docker rm uptime-kuma
docker run -d \
  --name uptime-kuma \
  --restart=always \
  -p 3001:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:1

    Update with Docker Compose:

    Update via Compose
    docker-compose pull
docker-compose up -d

    ⚠️ Note: Always backup before updating!

    12

    Troubleshooting

    Container Won't Start

    Check container logs for errors:

    View Logs
    docker logs uptime-kuma

    Can't Access Dashboard

    Verify container and port status:

    Check Status
    docker ps | grep uptime-kuma
sudo netstat -tlnp | grep 3001

    Notifications Not Working

    • • Test notification settings individually
    • • Check firewall rules allow outbound connections
    • • Verify API tokens and credentials are correct
    • • Review container logs for error messages

    💬 Need Help? Our support team is available 24/7 to assist with deployment issues.

    Best Practices

    • ✓Use SSL/TLS (HTTPS) for production deployments
    • ✓Enable two-factor authentication for admin accounts
    • ✓Set appropriate check intervals to avoid overwhelming services
    • ✓Configure multiple notification channels for redundancy
    • ✓Regularly backup your monitoring data
    • ✓Monitor the monitor - set up external checks for Uptime Kuma itself

    Why Choose RamNode for Uptime Kuma?

    •High uptime SLA for reliable monitoring
    •Multiple datacenter locations
    •Fast NVMe SSD storage
    •Flexible resources - upgrade anytime
    •DDoS protection included
    •24/7 expert support