Install Uptime Kuma di VPS Ubuntu dengan Docker, Monitor Website Kamu 24 Jam

Kenapa Website Kamu Butuh Monitoring Uptime

Website yang down diam-diam adalah kerugian yang tidak terlihat sampai terlambat. Pengunjung yang menemui halaman error tidak menunggu, mereka pindah ke kompetitor. Karena itu, install Uptime Kuma di VPS menjadi langkah paling murah untuk memastikan kamu tahu website down dalam hitungan detik, bukan setelah ada yang komplain di media sosial.

Uptime Kuma adalah alat self-hosted monitoring yang mengecek website, API, dan layanan kamu setiap 20 detik, lalu mengirim peringatan lewat Telegram, Discord, email, dan lebih dari 90 layanan notifikasi lainnya. Proyek ini sangat populer: repositori GitHub louislam/uptime-kuma mencatat 93.388 bintang dan 8.679 fork per 9 November 2026, dengan 140 rilis sejak pertama dibuat pada 3 Juli 2021. Versi stabil terbarunya adalah seri 2.x, dan cabang 1.x sudah tidak lagi mendapat pembaruan menurut panduan ForestsNet Cloud yang diperbarui September 2026.

Artikel ini adalah tutorial lengkap install Uptime Kuma di VPS Ubuntu dengan Docker Compose, lengkap dengan reverse proxy Nginx, SSL gratis dari Let’s Encrypt, notifikasi Telegram, dan status page publik. Semua langkah self-hosted monitoring ini sudah disusun berurutan dan bisa kamu ikuti dari nol sampai monitoring berjalan.

Apa Itu Uptime Kuma

Uptime Kuma adalah uptime monitor dan alat monitoring website self-hosted berlisensi MIT yang kamu jalankan di server sendiri. Berbeda dengan layanan berbayar seperti UptimeRobot, seluruh data monitoring tersimpan di VPS kamu sendiri, tidak ada batas jumlah monitor, dan tidak ada biaya bulanan selain server yang sudah kamu sewa. Untuk kebutuhan server monitoring yang ringan, Uptime Kuma adalah salah satu pilihan paling populer di kalangan self-hoster.

Jenis monitor yang didukung Uptime Kuma antara lain HTTP(s), HTTP(s) Keyword, HTTP(s) Json Query, TCP, Ping, DNS Record, Push, Websocket, Steam Game Server, dan Docker Containers. Uptime Kuma juga menampilkan info sertifikat SSL, monitor SSL untuk masa berlaku sertifikat, grafik ping, dan mendukung 2FA untuk melindungi dashboard. Antarmukanya berjalan di atas WebSocket sehingga status monitor diperbarui secara real-time tanpa perlu me-refresh halaman.

Kebutuhan sumber dayanya kecil. Menurut panduan Virtua Cloud, Uptime Kuma v2.x hanya memakai sekitar 80 sampai 120 MB RAM, dan VPS dengan 512 MB RAM dan 1 vCPU sudah cukup untuk puluhan monitor. Karena itu, VPS termurah yang kamu punya sudah lebih dari cukup untuk menjalankan monitoring ini.

Satu aturan penempatan yang wajib kamu patuhi: jangan menjalankan Uptime Kuma di server yang sama dengan website yang kamu monitor. Kalau server itu mati, monitor ikut mati dan kamu tidak menerima peringatan apa pun. Gunakan VPS terpisah, idealnya di provider atau lokasi berbeda dari server utama kamu.

1. Siapkan VPS dan Domain untuk Uptime Kuma

Sebelum mulai install Uptime Kuma di VPS, siapkan dua hal berikut.

Pertama, VPS Ubuntu 24.04 atau Debian 12/13 dengan minimal 1 vCPU dan 512 MB RAM. VPS ini sebaiknya terpisah dari server website utama kamu, sesuai aturan penempatan di atas. Pastikan kamu bisa login lewat SSH sebagai pengguna dengan hak sudo.

Kedua, subdomain khusus untuk dashboard monitoring, misalnya status.domainkamu.com. Buat record DNS tipe A yang mengarah ke alamat IP VPS monitoring kamu, lalu tunggu sampai propagasi DNS selesai. Kamu bisa mengeceknya dengan perintah berikut:

dig +short status.domainkamu.com

Perintah di atas harus menampilkan alamat IP VPS kamu. Kalau belum, tunggu beberapa menit lalu cek lagi.

Terakhir, amankan dulu VPS barunya. Kalau kamu belum pernah melakukannya, ikuti panduan Amankan VPS Ubuntu Baru dalam 30 Menit, 8 Langkah Anti Bobol untuk Pemula sebelum lanjut ke langkah berikutnya.

2. Install Docker dan Docker Compose di VPS Ubuntu

Uptime Kuma paling mudah dijalankan lewat Docker. Kalau Docker belum terpasang di VPS kamu, install dengan dua perintah berikut:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Perintah pertama mengunduh dan menjalankan skrip instalasi resmi Docker. Perintah kedua menambahkan pengguna kamu ke grup docker agar bisa menjalankan perintah docker tanpa sudo. Setelah itu, logout lalu login lagi lewat SSH agar perubahan grup berlaku.

Verifikasi instalasi Docker dan plugin Compose dengan perintah berikut:

docker --version
docker compose version

Kedua perintah harus menampilkan nomor versi tanpa error. Kalau docker compose version gagal, berarti plugin Compose belum terpasang dan kamu perlu menginstal Docker ulang lewat repositori resmi Ubuntu 24.04.

3. Install Uptime Kuma di VPS dengan Docker Compose

Buat direktori khusus untuk Uptime Kuma, lalu tulis file Compose di dalamnya:

mkdir -p /opt/uptime-kuma && cd /opt/uptime-kuma
nano compose.yaml

Isi file compose.yaml dengan konfigurasi berikut:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    container_name: uptime-kuma
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - uptime-kuma:/app/data

volumes:
  uptime-kuma:

Ada tiga keputusan penting dalam konfigurasi ini. Pertama, image dipin ke tag 2 agar kamu selalu memakai seri 2.x yang masih didukung, bukan 1.x yang sudah ditinggalkan. Kedua, port 3001 hanya di-bind ke 127.0.0.1 sehingga dashboard tidak bisa diakses langsung dari internet; akses publik nanti hanya lewat reverse proxy. Ketiga, seluruh data Uptime Kuma tersimpan di named volume uptime-kuma, jadi data tidak hilang saat container dihapus atau diperbarui.

Jalankan Uptime Kuma dengan perintah berikut:

docker compose up -d
docker compose ps

Tunggu sekitar 30 detik, lalu cek log untuk memastikan tidak ada error:

docker compose logs -f uptime-kuma

Tekan Ctrl+C untuk keluar dari log. Kalau log menampilkan baris bahwa server sudah berjalan, instalasi berhasil. Dashboard Uptime Kuma sekarang aktif di port 3001, tapi masih tertutup dari internet sampai reverse proxy dipasang pada langkah berikutnya.

4. Amankan Uptime Kuma dengan Reverse Proxy Nginx dan SSL

Dashboard Uptime Kuma berjalan di atas WebSocket, jadi reverse proxy harus meneruskan header Upgrade dan Connection serta menjaga header Host tetap utuh. Tanpa konfigurasi ini, dashboard akan gagal memuat atau terus terputus.

Install Nginx dan Certbot di VPS monitoring kamu:

sudo apt update && sudo apt install -y nginx python3-certbot-nginx

Buat file konfigurasi Nginx untuk subdomain kamu:

sudo nano /etc/nginx/sites-available/status.domainkamu.com

Isi dengan konfigurasi berikut, ganti status.domainkamu.com dengan subdomain kamu sendiri:

server {
    listen 80;
    server_name status.domainkamu.com;

    location / {
        proxy_pass http://127.0.0.1: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;
    }
}

Aktifkan konfigurasi dan uji sintaksnya:

sudo ln -s /etc/nginx/sites-available/status.domainkamu.com /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Sekarang pasang sertifikat SSL gratis dari Let’s Encrypt:

sudo certbot --nginx -d status.domainkamu.com

Certbot akan memperbarui konfigurasi Nginx secara otomatis dan mengatur perpanjangan sertifikat. Setelah selesai, buka https://status.domainkamu.com di browser. Kalau halaman pembuatan akun admin Uptime Kuma muncul dengan gembok aman, reverse proxy dan SSL kamu sudah benar.

Jangan lupa tutup port yang tidak perlu di firewall. Uptime Kuma tidak butuh port publik selain 80 dan 443:

sudo ufw allow OpenSSH
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

5. Buat Akun Admin dan Aktifkan 2FA

Saat pertama kali membuka dashboard, Uptime Kuma meminta kamu membuat akun admin. Isi username dan password yang kuat, lalu klik Create. Akun pertama ini otomatis menjadi administrator dan tidak bisa dibuat akun kedua dengan cara yang sama.

Setelah masuk, aktifkan autentikasi dua faktor (2FA) dari menu Settings, lalu Security. Pindai kode QR dengan aplikasi autentikator di HP kamu dan simpan kode cadangan di tempat aman. Langkah ini penting karena dashboard monitoring adalah pintu masuk ke seluruh informasi infrastruktur kamu.

Periksa juga pengaturan bahasa dan zona waktu di menu Settings. Uptime Kuma mendukung banyak bahasa dan zona waktu, jadi atur ke Asia/Jakarta agar jam pada grafik dan riwayat insiden sesuai dengan waktu kamu.

6. Tambah Monitor Website, API, dan Sertifikat SSL

Sekarang tambahkan monitor pertama kamu. Klik tombol Add Monitor di dashboard, lalu isi formulirnya.

Untuk website, pilih tipe monitor HTTP(s) dan isi URL lengkapnya, misalnya https://domainkamu.com. Atur Heartbeat Interval ke 60 detik dan Retry ke 2 atau 3 kali. Interval 60 detik sudah cukup untuk website pribadi; interval 20 detik yang didukung Uptime Kuma hanya perlu untuk layanan yang sangat kritis. Retry mencegah alert palsu akibat satu kali gagal jaringan sesaat.

Aktifkan juga monitor SSL untuk sertifikat website kamu dengan cara yang sama. Uptime Kuma menampilkan sisa hari sertifikat lewat monitor SSL dan memberi peringatan sebelum sertifikat kedaluwarsa, jadi kamu tidak akan lagi mendapati website tidak bisa dibuka karena SSL mati diam-diam.

Tambahkan monitor uptime untuk setiap layanan penting lainnya: endpoint API dengan tipe HTTP(s) Keyword agar kamu tahu bukan hanya servernya hidup tapi responsnya benar, port database atau SSH dengan tipe TCP, DNS record penting dengan tipe DNS Record, serta ping monitor sederhana dengan tipe Ping. Untuk layanan di dalam Docker di server lain, tipe Docker Containers bisa memantau status container secara langsung.

Satu hal yang sering dilupakan pemula: monitor halaman checkout atau halaman login, bukan hanya halaman depan. Halaman depan bisa hidup sementara proses penting di belakangnya sudah mati. Monitor keyword pada halaman kritis menangkap masalah yang tidak terlihat dari halaman depan.

7. Atur Notifikasi Telegram agar Downtime Langsung Terdeteksi

Monitor tanpa notifikasi sama saja dengan alarm yang tidak berbunyi. Uptime Kuma mendukung lebih dari 90 layanan notifikasi, dan Telegram adalah yang paling praktis untuk pengguna di Indonesia.

Pertama, buat bot Telegram lewat BotFather. Buka Telegram, cari @BotFather, kirim perintah /newbot, ikuti instruksinya, lalu salin token bot yang diberikan. Setelah itu, kirim satu pesan apa saja ke bot baru kamu agar Telegram mencatat chat tersebut.

Kedua, cari tahu Chat ID kamu. Kirim pesan ke @userinfobot di Telegram, lalu catat angka ID yang dikembalikan. Alternatifnya, buka https://api.telegram.org/botTOKEN_KAMU/getUpdates di browser setelah mengirim pesan ke bot dan lihat angka pada kolom chat id.

Ketiga, masuk ke Uptime Kuma, buka Settings, lalu Notifications, dan klik Setup Notification. Pilih Telegram, isi Bot Token dan Chat ID, lalu klik Test. Kalau pesan uji sampai ke Telegram kamu, notifikasi sudah aktif.

Terakhir, pasang notifikasi ini ke setiap monitor penting. Buka monitor, masuk ke tab Notifications, dan centang notifikasi Telegram yang baru kamu buat. Tanpa langkah ini, monitor berjalan tapi tidak ada peringatan yang terkirim saat website down.

8. Buat Status Page Publik untuk Pengunjung

Status page adalah halaman publik yang menampilkan kondisi layanan kamu secara transparan, lengkap dengan riwayat uptime. Pengunjung bisa melihat sendiri apakah website sedang bermasalah tanpa harus menghubungi kamu.

Buat status page dari menu Status Pages, lalu klik New Status Page. Beri nama sesuai brand kamu, tambahkan monitor yang ingin ditampilkan, dan atur apakah riwayat insiden ditampilkan atau tidak. Kamu bisa memetakan status page ke domain sendiri, misalnya status.domainkamu.com yang sudah kamu siapkan di langkah 4, atau memakai subdomain bawaan.

Bagikan tautan status page di footer website atau halaman kontak kamu. Saat website down, pengunjung yang mengecek status page akan tahu bahwa kamu sudah menyadari masalahnya, dan itu jauh lebih baik daripada halaman error tanpa penjelasan.

Cara Update dan Backup Uptime Kuma

Uptime Kuma merilis pembaruan secara rutin, dan memperbaruinya lewat Docker Compose hanya butuh dua perintah:

cd /opt/uptime-kuma
docker compose pull && docker compose up -d

Karena image dipin ke tag 2, perintah di atas hanya menarik patch dan minor terbaru dari seri 2.x tanpa lompat ke versi mayor yang berisiko merusak konfigurasi.

Untuk backup, seluruh data Uptime Kuma ada di named volume uptime-kuma. Cadangkan volume itu secara berkala dengan perintah berikut:

docker run --rm -v uptime-kuma:/data -v $(pwd):/backup alpine tar czf /backup/uptime-kuma-backup.tar.gz -C /data .

Simpan file backup di luar VPS, misalnya di laptop atau penyimpanan cloud kamu. Untuk memulihkan, buat volume baru dengan nama yang sama lalu ekstrak arsip ke dalamnya sebelum menjalankan docker compose up -d.

Jangan lupa soal log. Container Uptime Kuma menulis log yang terus bertambah, dan log Docker yang tidak dirotasi bisa memenuhi disk VPS secara diam-diam. Kalau kamu belum mengaturnya, baca panduan Agar Disk VPS Tidak Penuh Diam-Diam, Atur Rotasi Log Docker Sekarang agar VPS monitoring kamu tetap sehat dalam jangka panjang.

FAQ Seputar Uptime Kuma

Apakah Uptime Kuma gratis?

Ya, Uptime Kuma adalah uptime monitor gratis dan open source dengan lisensi MIT. Kamu hanya membayar VPS tempat ia berjalan, dan VPS 512 MB RAM sudah cukup menurut panduan SelfHostAtlas.

Berapa interval cek tercepat Uptime Kuma?

Interval tercepat yang didukung adalah 20 detik. Untuk kebanyakan website, interval 60 detik dengan retry 2 sampai 3 kali sudah cukup dan menghasilkan lebih sedikit alarm palsu.

Apakah Uptime Kuma bisa memantau server yang sama tempat ia diinstall?

Bisa secara teknis, tapi tidak disarankan. Kalau server itu mati, Uptime Kuma ikut mati dan tidak ada peringatan yang terkirim. Selalu jalankan Uptime Kuma di VPS terpisah dari layanan yang dipantau.

Apakah data monitoring Uptime Kuma aman disimpan di VPS sendiri?

Ya, seluruh data tersimpan di volume lokal VPS kamu dan tidak dikirim ke pihak ketiga. Pastikan dashboard dilindungi reverse proxy dengan SSL dan 2FA aktif, seperti dijelaskan pada langkah 4 dan 5.

Dengan delapan langkah di atas, install Uptime Kuma di VPS selesai dan monitoring website kamu kini berjalan 24 jam. Mulai dari satu monitor untuk website utama, tambah monitor lain sedikit demi sedikit, dan pasang notifikasi Telegram agar alert downtime sampai ke kamu dalam hitungan detik. Monitoring yang baik bukan soal alat yang mahal, tapi soal tahu lebih dulu sebelum pengunjung yang memberi tahu.

Install Uptime Kuma di VPS adalah investasi kecil dengan dampak besar: satu container Docker ringan di VPS terpisah, dipasang di balik Nginx dengan SSL gratis, dan dihubungkan ke Telegram, sudah cukup untuk membuat monitoring website kamu berjalan tanpa henti dan mengubah cara kamu merespons downtime dari reaktif menjadi proaktif. Dengan 93.388 bintang di GitHub per 9 November 2026 dan komunitas yang aktif, Uptime Kuma adalah uptime monitor dan pilihan self-hosted monitoring yang terbukti dan terus diperbarui. Pasang hari ini, dan biarkan Uptime Kuma yang berjaga sementara kamu tidur nyenyak.