İçeriğe geç
zefıly
← Tüm yazılar

Uptime Kuma 2'yi kendi sunucunuzda çalıştırmak

4 dk okuma

Uptime Kuma 2, Docker ile nasıl çalıştırılır. İlk başlangıçtaki yeni veritabanı seçimi, ihtiyaç duyduğu ters vekil ayarları, bir kesintiyi size gerçekten haber verebilmesi için nerede çalışması gerektiği, yedekler ve güncellemeler. 2.5 ile denendi.

Uptime Kuma, web sitelerinizi ve hizmetlerinizi her dakika denetler ve biri yanıt vermeyi bıraktığında size haber verir. Kullanımı kolay bir arayüzü olan tek bir kapsayıcıdır; uyarıları e-posta, Telegram, Slack, Discord ve daha birçok kanala gönderir.

Buradaki komutları 12 Kasım 2026'da 2 imaj etiketiyle denedik; o gün bu etiket Uptime Kuma 2.5.11 idi.

Kısaca

  • Tek kapsayıcı, tek birim (/app/data).
    1. sürüm ilk başlangıçta hangi veritabanını kullanacağını sorar. Neredeyse herkes için doğru seçim SQLite'tır.
  • Arayüz, ters vekilde WebSocket desteği ister.
  • Boşta duran kapsayıcımız yaklaşık 130 MB bellek kullandı.
  • Yalnızca izlediği sunucuda çalıştırmayın. O sunucu kapanırsa alarm da kapanır.

1. Kapsayıcıyı başlatın

docker volume create kuma_data

docker run -d --name uptime-kuma --restart unless-stopped \
  -p 127.0.0.1:3001:3001 \
  -v kuma_data:/app/data \
  docker.io/louislam/uptime-kuma:2

127.0.0.1:3001 portu özel tutar; HTTPS'i öndeki web sunucusu ekler. 2 etiketi en yeni 2.x sürümünü izler. Tam denetim için 2.5.11 gibi kesin bir sürümü sabitleyin.

2. Ters vekil

Uptime Kuma sayfalarını WebSocket bağlantısı üzerinden günceller. Yükseltme başlıkları olmadan sayfa açılır ve boş kalır.

server {
    server_name status.example.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-Proto $scheme;
    }
}

3. İlk başlangıç: veritabanını seçin

Bu, 2. sürümle geldi. İlk ziyaret /setup-database adresine yönlendirilir ve orada seçim yaparsınız:

  • SQLite: veri biriminde bir dosya. Çalıştırılacak başka bir şey yoktur. Aksi için bir nedeniniz yoksa bunu seçin.
  • MariaDB: kapsayıcıya gömülü ya da harici bir sunucu. Uzun geçmişli yüzlerce izleme için yararlıdır.

Ardından yönetici hesabını oluşturursunuz. Hemen yapın: hesap oluşana kadar adresi ilk açan kişi yönetici olur.

4. İzlemeleri ekleyin

İyi bir başlangıç seti:

  • Her web sitesi için HTTP(s); anahtar sözcük denetimiyle, böylece 200 durum kodlu bir hata sayfası da kapalı sayılır.
  • HTTP izlemesinin parçası olan sertifika süresi: sertifika bitmeden günler önce uyarı alın.
  • Veritabanları ve posta sunucuları için TCP portu.
  • Sunucunun kendisi için Ping.
  • Cron işleri için Push: iş bittiğinde bir adresi çağırır, çağrı gelmezse Kuma sizi uyarır.

En az bir bildirim kanalı kurun ve deneme iletisi gönderin. Kimsenin duymadığı izleme süstür.

5. Nerede çalıştırmalı

İzlediği siteyle aynı sunucuda duran izlemenin kör noktası vardır. Sunucunun elektriği ya da ağı kesildiğinde site kapanır, izleme de onunla birlikte kapanır. Kimseye haber gitmez.

Daha iyisi:

  • Uptime Kuma'yı başka bir sunucuda çalıştırın; tercihen başka bir sağlayıcıda ya da en azından başka bir bölgede.
  • Ya da yerinde bırakın ve Kuma kurulumunun kendisi için bir dış denetim ekleyin.

Bunun için küçük, ucuz bir VPS yeter.

6. Durum sayfaları

Uptime Kuma durum sayfası yayımlayabilir: seçtiğiniz izlemeleri ve olayları gösteren herkese açık bir sayfa. Durum sayfasını status.example.com gibi kendi alan adına bağlayabilirsiniz. Yönetim arayüzü girişinizin arkasında kalır.

Yönetim arayüzüne herkes erişememeliyse siteyi IP adresine göre kısıtlayın ya da önüne parola koyun; yalnızca durum sayfası yolunu açık bırakın.

7. Yedekler

Her şey /app/data içindedir: veritabanı, yüklenen görseller ve ayarlar.

docker stop uptime-kuma
docker run --rm -v kuma_data:/data -v "$PWD":/backup alpine \
  tar czf /backup/kuma-$(date +%F).tar.gz -C /data .
docker start uptime-kuma

Arşivi sunucunun dışına kopyalayın.

8. Güncellemeler

docker pull docker.io/louislam/uptime-kuma:2
docker stop uptime-kuma && docker rm uptime-kuma
# aynı docker run komutunu yeniden çalıştırın

1. sürümden mi geliyorsunuz? 2. sürümün ilk başlangıcı veritabanını taşır; uzun bir geçmişle bu zaman alabilir. Önce veri birimini yedekleyin ve taşımayı yarıda kesmeyin.

Zefily ile

Uptime Kuma, Zefily'de tek tıkla kurulan bir uygulamadır: sitenin kendi Linux kullanıcısı altında yetkisiz (rootless) bir kapsayıcı, 127.0.0.1 üzerinde, HTTPS ve WebSocket destekli web sunucusunun arkasında; verisi güncellemelerden etkilenmeyen bir birimde. Site parola korumalı başlar ve bir İlk adım bildirimi yönetici hesabını oluşturmanızı hatırlatır. Konteyner uygulamaları belgesine bakın.

Zefily'nin panelde kendi çalışma süresi denetimleri ve durum sayfaları da vardır. Durum sayfaları belgesine bakın.

Sık sorulan sorular

Uptime Kuma 2 için hangi veritabanını seçmeliyim?

Yüzlerce izlemeniz yoksa SQLite. Veri biriminde bir dosyadır ve başka hiçbir şey istemez.

Uptime Kuma sayfası nginx arkasında neden boş?

Arayüz WebSocket kullanır. Vekil yapılandırmasına Upgrade ve Connection başlıklarını ve proxy_http_version 1.1 satırını ekleyin.

Uptime Kuma ne kadar bellek kullanır?

Boşta duran Uptime Kuma 2.5.11 kapsayıcımız yaklaşık 130 MB kullandı. İzleme sayısıyla artar.

Uptime Kuma sitelerimle aynı sunucuda mı çalışmalı?

Tercihen hayır. O sunucu kapanırsa izleme de kapanır ve uyarı göndermez. Başka bir yerde çalıştırın ya da izlemenin kendisi için dış bir denetim ekleyin.

Uptime Kuma verisini nerede tutar?

Kapsayıcının içindeki /app/data dizininde. O birimi yedekleyin.

Zefily ile kendi imajlarınızı çalıştırmak için Konteynerler belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →