Uptime Kuma Kurulumu 2026: Site ve Servis İzleme, Durum Sayfası, Yedekleme

Web sitesi, e-posta sunucusu ya da şirket içi bir uygulama durduğunda bunu müşteriden duymak, en pahalı öğrenme yoludur. Bir izleme aracı servisleri düzenli aralıklarla yoklar ve sorun çıktığı anda Telegram, e-posta ya da Slack ile haber verir. Uptime Kuma, kendi sunucunuzda çalışan, kurulumu kolay ve MIT lisanslı bir izleme aracıdır. Bu rehberde Uptime Kuma 2'nin kurulumunu, veritabanı seçimini, sınırlarını ve yedeklemesini resmi GitHub belgelerine dayanarak (Ekim 2026, sürüm 2.5.5) anlatıyoruz.

Uptime Kuma neleri izler?

• İzleme türleri: HTTP(S), sayfada belirli bir kelimenin varlığı, JSON yanıtı sorgusu, TCP portu, ping, DNS kaydı, WebSocket, Docker konteynerleri ve "push" (izlenen sistemin kendisi düzenli sinyal gönderir; cron işleri ve yedekleme betikleri için uygundur). Kaynak kodunda veritabanları, MQTT ve SMTP gibi ek türler de bulunur.
• Bildirimler: README'ye göre Telegram, Discord, Slack, Pushover, e-posta (SMTP) dahil 90'dan fazla bildirim servisi.
• Durum sayfaları: birden çok herkese açık durum sayfası oluşturulabilir ve her biri kendi alan adına bağlanabilir (ör. durum.sirketiniz.com). Planlı bakım pencerelerinde bildirimler susturulur ve durum sayfasında bakım mesajı gösterilir.
• Diğer: 20 saniyeye kadar inen yoklama aralığı, SSL sertifika bilgisi, vekil sunucu desteği ve iki aşamalı doğrulama.

Kurulum

Resmi önerilen yol Docker'dır. Docker etiketlerinde bilinmesi gereken üç nokta:

• 2 etiketi önerilendir. Resmi belgelere göre latest etiketi kullanımdan kalkmıştır ve hâlâ 1. sürümü gösterir; yeni kurulumda kullanılmamalıdır.
• 2-slim imajı yaklaşık 300–400 MB daha küçüktür. Ancak bu imajda gömülü MariaDB ve tarayıcı tabanlı izleme için gereken Chromium yoktur.
• Root olmadan çalışan (rootless) imajlarda bazı özellikler beklendiği gibi çalışmayabilir.

Docker dışında kurulum için Node.js 20.4 veya üzeri, Git ve pm2 gerekir. Debian, Ubuntu, Fedora gibi yaygın Linux dağıtımları ile Windows 10 ve Windows Server 2012 R2 ve sonrası desteklenir; FreeBSD desteklenmez.

Veri klasörü yerel diskte olmalı: README, NFS gibi ağ dosya sistemlerinin desteklenmediğini vurgular. Kurulum belgesi de SQLite veritabanının bozulmaması için POSIX dosya kilidi desteği gerektiğini belirtir. Veri klasörünü yerel bir dizine ya da Docker volume'üne bağlayın.

Ters vekil: Uptime Kuma arayüzü WebSocket ile çalışır. Belgelere göre NGINX gibi bir ters vekilde Upgrade ve Connection başlıkları ayrıca iletilmelidir; aksi halde arayüz açılır ama güncellenmez.

Veritabanı: SQLite mi, MariaDB mi?

2.0 ile birlikte SQLite'ın yanında MariaDB de desteklenmeye başladı. Tam imajda gömülü bir MariaDB bulunur ve belgeler onu "az bakım isteyen, dayanıklı ve performanslı" bir seçenek olarak tanımlar. Slim imajla da harici bir MariaDB/MySQL sunucusuna bağlanılabilir. Önemli kural: belgelere göre SQLite'tan MariaDB'ye doğrudan geçiş yapılamaz ve resmi olarak desteklenmez. Çok sayıda izleme ve uzun geçmiş saklamayı planlıyorsanız veritabanını ilk kurulumda seçin.

Bilinmesi gereken sınırlar

• Kendi çöküşünü haber veremez: Uptime Kuma, çalıştığı sunucu durduğunda uyarı gönderemez. Bu bir yazılım hatası değil, tek noktadan izlemenin doğal sonucudur. Aracı izlenen sistemlerden ayrı bir sunucuda, mümkünse farklı bir veri merkezinde çalıştırın. İsterseniz Uptime Kuma'nın kendisini de dışarıdaki ikinci bir izleme noktasından izleyin.
• Çok kullanıcılı yönetim yok: GitHub'da 2021'de açılan kullanıcı yönetimi isteği (issue #128) hâlâ açıktır. Ekipte herkes aynı yönetici hesabını kullanır. Erişimi bu yüzden kısıtlı tutun ve iki aşamalı doğrulamayı açın.
• Kümeleme yok: resmi belgelerde yüksek erişilebilirlik ya da küme kurulumu tarif edilmez. Tek sunuculu bir araç olarak planlayın.

Yedekleme ve 1.x'ten 2.0'a geçiş

2.0 sürümüyle eski JSON yedekleme/geri yükleme özelliği kaldırıldı. Göç belgesine göre şu an desteklenen tek yedekleme yöntemi data klasörünün yedeklenmesidir (Docker'da /app/data). Tutarlı bir kopya için yedeği konteyner durdurulmuşken almak en güvenli yoldur. Gömülü ya da harici MariaDB kullanıyorsanız veritabanı dökümünü de ekleyin.

1.x'ten 2.0'a geçiş için resmi uyarılar:

• Önce data klasörünü yedekleyin; belge bunu birkaç kez tekrarlar.
• Göç sırasında geçmiş kalp atışı (heartbeat) verisi yeniden toplandığı için süreç uzun sürebilir. Belgedeki örnekte 20 izleme ve 90 günlük veri yaklaşık 7 dakika sürmüştür; yavaş donanımda ya da çok sayıda izlemede saatler alabilir.
• Göç işlemi yarıda kesilmemelidir. Kesilirse yedekten geri dönüp yeniden denemek gerekir.
• Node.js 18 ve öncesi ile Alpine tabanlı imajlar artık desteklenmez. Yeni oluşturulan izlemelerde varsayılan yeniden deneme sayısı 1'den 0'a indi.

Yedeklerin ayrı bir yerde tutulması ve geri yüklemenin denenmesi için yedekleme ve izleme rehberimize bakabilirsiniz.

Uptime Kuma kimler için uygun değil?

• Sunucu kaynaklarını (CPU, RAM, disk) ayrıntılı izlemek isteyenler: Uptime Kuma erişilebilirliği izler. Metrik ve grafik için Prometheus ve Grafana ya da Netdata gibi araçlar gerekir.
• Ekip üyelerine ayrı yetki vermek isteyenler: kullanıcı ve rol yönetimi yoktur.
• Birden çok konumdan ölçüm isteyenler: tek kurulum tek noktadan ölçer. Farklı bölgelerden ölçüm için birden fazla kurulum gerekir.

e-veri.com ile Uptime Kuma

Uptime Kuma'yı, izlenen sistemlerinizden ayrı olarak Türkiye'deki sunucularımızda yönetilen hosting şeklinde ya da sizin seçtiğiniz bir sunucuda kuruyoruz. Kapsam:

• Docker ile 2. sürüm kurulumu, HTTPS ve WebSocket uyumlu ters vekil
• Web siteleri, e-posta, DNS, SSL ve yedekleme işleriniz için izlemelerin tanımlanması
• Telegram ya da e-posta bildirimleri
• Şirket alan adınızda durum sayfası
• Data klasörü yedeği ve sürüm güncellemeleri

Teklif için kurumsal hizmetler sayfasındaki formu doldurabilirsiniz.

Sık sorulan sorular

Uptime Kuma ücretsiz mi?

Evet. Uptime Kuma MIT lisanslıdır; ücretli ya da kurumsal bir sürümü yoktur. Proje GitHub Sponsors ve Open Collective bağışlarıyla desteklenir.

Uptime Kuma hangi Docker imajıyla kurulmalı?

Resmi önerilen etiket louislam/uptime-kuma:2'dir. latest etiketi kullanımdan kalkmıştır ve hâlâ 1. sürümü gösterir. 2-slim imajı daha küçüktür ama gömülü MariaDB ve Chromium içermez.

Uptime Kuma hangi veritabanını kullanır?

SQLite ya da 2.0'dan itibaren MariaDB (tam imajda gömülü ya da harici). Belgelere göre SQLite'tan MariaDB'ye doğrudan geçiş desteklenmez; veritabanı ilk kurulumda seçilmelidir.

Uptime Kuma verisi NFS üzerinde tutulabilir mi?

Hayır. README'ye göre NFS gibi ağ dosya sistemleri desteklenmez; veri klasörü yerel bir dizine ya da Docker volume'üne bağlanmalıdır.

Uptime Kuma yedeği nasıl alınır?

2.0 ile JSON yedekleme özelliği kaldırıldı; desteklenen tek yöntem data klasörünün (Docker'da /app/data) yedeklenmesidir. MariaDB kullanılıyorsa veritabanı dökümü de alınmalıdır.

Uptime Kuma'da birden çok kullanıcı tanımlanabilir mi?

Hayır. Kullanıcı yönetimi isteği GitHub'da 2021'den beri açık bir talep olarak duruyor; şu an tek yönetici hesabı kullanılır. Erişim kısıtlı tutulmalı ve iki aşamalı doğrulama açılmalıdır.