Homarr Nedir ve Sürükle Bırak Sunucu Panosu Kurulumu

Bir sunucuda uzun süre çalışırsanız, er ya da geç aynı sorunla karşılaşırsınız: onlarca servis, onlarca farklı port ve tarayıcının yer imlerinde birbirine karışmış bir sürü bağlantı. Portainer 9000 portunda, ortam izleme aracınız 3001'de, medya sunucunuz 8096'da, dosya paylaşımınız başka bir alt alan adında... Bir süre sonra "şu servis hangi adresteydi" diye düşünmeye başlarsınız. İşte Homarr tam bu dağınıklığı toparlamak için doğmuş, açık kaynak ve kendi sunucunuzda barındırabileceğiniz modern bir başlangıç panosudur (dashboard). Tek bir sayfada tüm servislerinizi ikonlarıyla listeler, sürükle bırak ile diziler ve pek çoğunun anlık durumunu doğrudan panonun üstünde gösterir.

Homarr'ı benzerlerinden ayıran en belirgin özellik, düzenleme deneyiminin tamamen tarayıcı üzerinden ve sürükle bırak mantığıyla yürümesidir. YAML dosyaları elle düzenlemek yerine kutucukları fareyle tutup istediğiniz yere bırakır, boyutlandırır ve gruplarsınız. Bunun yanında Sonarr, Radarr, qBittorrent, Pi-hole gibi popüler uygulamalarla konuşan hazır widget'ları sayesinde pano yalnızca bir bağlantı listesi olmaktan çıkar; indirme kuyruğunu, reklam engelleme istatistiklerini veya disk kullanımını doğrudan ana ekranda görebileceğiniz canlı bir kontrol merkezine dönüşür. Bu rehberde Homarr'ın ne işe yaradığını, Docker ile nasıl kurulacağını, servis ve widget eklemeyi, düzen özelleştirmeyi ve popüler alternatifi Homepage ile farklarını kıdemli bir yöneticinin gözünden anlatacağım.

Homarr Nedir ve Neden Kullanılır#

Homarr, kendi sunucunuzda çalıştırdığınız servisleri tek bir açılış sayfasında toplayan, açık kaynak lisanslı bir "dashboard" uygulamasıdır. Teknik olarak konuşursak arka planda çalışan bir web uygulamasıdır; siz tarayıcıdan bağlanır, kutucukları düzenler ve sonucu tüm cihazlarınızdan aynı adrese giderek görürsünüz. Amacı basit ama etkilidir: sunucudaki her şeyi hatırlamak yerine, her şeyin göründüğü tek bir kapı yaratmak.

Bu tür bir panoyu neden kullanmak istersiniz? Birkaç somut senaryo üzerinden bakalım. Ev laboratuvarı (homelab) kuranlar için Homarr, ailenin de kolayca kullanabileceği bir başlangıç noktasıdır; teknik olmayan biri bile ikonlara tıklayarak medya sunucusuna veya fotoğraf arşivine ulaşır. Küçük bir işletme sunucusu işletiyorsanız, ekip üyeleri panele bakarak hangi araca nereden erişeceğini öğrenir ve size "şu adres neydi" sorusu gelmez. Birden fazla sunucu yönetiyorsanız her makine için ayrı bir pano açıp aralarında geçiş yapabilirsiniz. Homarr'ın öne çıkan yönleri şöyle özetlenebilir:

• Sürükle bırak düzen: Kutucukları fareyle taşır, boyutlandırır ve gruplarsınız; konfigürasyon dosyası yazmazsınız.
• Canlı widget'lar: Servislerin API'lerine bağlanıp indirme, disk, ağ veya reklam engelleme gibi verileri anlık gösterir.
• Durum göstergeleri: Her kutucuğun yanındaki yeşil/kırmızı nokta ilgili servisin ayakta olup olmadığını belirtir (basit bir "ping" mantığı).
• Çoklu tema ve özelleştirme: Renk, arka plan, kart saydamlığı ve düzen tamamen size ait.
• Docker uyumluluğu: Docker etiketlerini okuyup çalışan konteynerleri otomatik keşfedebilir.

Kısacası Homarr, sunucunuzun "vitrin katı"dır. Ağır iş yükünü Portainer gibi araçlara bırakır; kendisi ise erişimi ve genel görünürlüğü sadeleştirir. Konteyner yönetiminin detaylarını merak ediyorsanız Portainer nedir rehberimiz bu ikiliyi birlikte nasıl kullanacağınızı tamamlayıcı biçimde anlatır.

Docker ile Homarr Kurulumu#

Homarr'ı kurmanın en temiz yolu Docker'dır. Tek bir imaj indirir, kalıcı veriyi bir hacme bağlar ve saniyeler içinde çalışır hale gelirsiniz. Sunucunuzda Docker ve Docker Compose kurulu değilse önce onları hazırlayın:

# Docker'ı resmi betikle kur (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sudo sh

# Kullanıcınızı docker grubuna ekleyin (sudo'suz kullanım için)
sudo usermod -aG docker $USER

# Oturumu yenilemek için çıkış yapıp tekrar girin, ardından doğrulayın
docker --version
docker compose version

Şimdi Homarr için ayrı bir dizin oluşturup bir docker-compose.yml dosyası hazırlayalım. Aşağıdaki yapılandırma, panoyu 7575 portunda yayınlar ve iki kalıcı hacim kullanır: biri yapılandırma, diğeri yüklediğiniz ikonlar için.

services:
  homarr:
    image: ghcr.io/homarr-labs/homarr:latest
    container_name: homarr
    restart: unless-stopped
    volumes:
      # Docker keşfi için soketi salt-okunur bağlayın
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./homarr/appdata:/appdata
    environment:
      - SECRET_ENCRYPTION_KEY=BURAYA_64_KARAKTERLIK_HEX_ANAHTAR
      - TZ=Europe/Istanbul
    ports:
      - "7575:7575"

Buradaki SECRET_ENCRYPTION_KEY kritik bir alandır; Homarr, servis API anahtarları gibi hassas verileri bu anahtarla şifreler. Rastgele ve güçlü bir değer üretmek için:

# 64 karakterlik güvenli bir hex anahtar üretin
openssl rand -hex 32

Çıkan değeri Compose dosyasındaki ilgili satıra yapıştırın. Ardından konteyneri başlatın:

# Dizine girin ve arka planda başlatın
cd ~/homarr
docker compose up -d

# Logları izleyerek başlatmanın sorunsuz olduğunu görün
docker compose logs -f homarr

Birkaç saniye sonra tarayıcıdan http://SUNUCU_IP:7575 adresine gidin. İlk açılışta Homarr sizden bir yönetici hesabı oluşturmanızı ister; kullanıcı adı ve güçlü bir parola belirleyip devam edin. Artık boş ama kullanıma hazır bir panonuz var. Sunucunuz güvenlik duvarı arkasındaysa 7575 portunu yalnızca güvendiğiniz ağlara açmayı unutmayın; internete doğrudan açmak yerine ilerideki bölümde anlatacağımız reverse proxy yöntemini tercih edin.

İlk Yapılandırma ve Servis Ekleme#

Panoya ilk kez girdiğinizde karşınıza boş bir tuval çıkar. Homarr'da her şey "board" (pano) mantığıyla çalışır ve bir panonun üzerine kutucuklar (item) eklersiniz. En temel kutucuk türü "App", yani bir servise bağlantı veren uygulama kartıdır. Sağ üstteki kalem simgesine tıklayarak düzenleme moduna geçin; bu mod açıkken kutucuk ekleyebilir, taşıyabilir ve silebilirsiniz.

Bir servis eklemek için düzenleme modunda boş alana sağ tıklayıp "Add an app" seçeneğini kullanın. Karşınıza çıkan formda birkaç alanı doldurursunuz:

• Name: Kartın üzerinde görünecek ad, örneğin "Medya Sunucusu".
• Internal URL: Homarr'ın durum kontrolü ve widget verisi için kullanacağı iç adres (örneğin http://192.168.1.20:8096).
• External URL: Kullanıcı karta tıkladığında gideceği adres; genelde alan adınız veya dışarıdan erişilen URL olur.
• Icon: İkon; Homarr, binlerce servis logosu içeren geniş bir ikon setiyle gelir, adı yazmanız yeterlidir.

İç ve dış adres ayrımı önemlidir. Sunucu içinden yapılan durum kontrolleri genellikle yerel IP üzerinden en hızlı ve güvenilir sonucu verir; kullanıcı erişimi ise çoğu zaman alan adı ve HTTPS üzerinden yürür. Aşağıdaki tablo hangi alanın ne işe yaradığını netleştirir:

Servis ekledikten sonra "Ping" özelliğini açarsanız kartın köşesinde küçük bir durum noktası belirir. Bu, Homarr'ın belirttiğiniz iç adrese düzenli istek atıp yanıt alıp almadığını gösterir. Ancak bunu profesyonel bir uptime izleme çözümüyle karıştırmayın; Homarr'ın ping'i basit bir erişilebilirlik göstergesidir. Servislerin gerçekten çalışıp çalışmadığını geçmişe dönük raporlarla, kesinti bildirimleriyle ve SLA hesabıyla takip etmek isterseniz Uptime Kuma nedir rehberimizdeki yaklaşımı Homarr'ın yanında kullanmanızı öneririm.

Widget'lar ve Uygulama Entegrasyonları#

Homarr'ı sıradan bir bağlantı sayfasından ayıran asıl güç widget'lardır. Widget, bir servisin API'sine bağlanıp onun verisini doğrudan panoda gösteren canlı bir kutucuktur. Örneğin bir indirme istemcisi widget'ı, o an inen dosyaları ve hızları listeler; bir reklam engelleyici widget'ı ise engellenen sorgu sayısını grafikle sunar. Böylece ilgili servise girmeden pek çok bilgiyi tek bakışta alırsınız.

Entegrasyon kurmak için önce ilgili servisin API anahtarını edinmeniz gerekir. Çoğu uygulamada bu anahtar, kendi ayarlar sayfasındadır. Homarr tarafında ise eklediğiniz App kartını düzenleyip "Integrations" sekmesinden servis türünü seçer ve anahtarı girersiniz. Anahtar, girilen SECRET_ENCRYPTION_KEY ile şifrelenerek saklanır; bu yüzden o anahtarı kaybetmemeniz önemlidir. Sık kullanılan bazı entegrasyon türleri şunlardır:

• İndirme yöneticileri: qBittorrent, Deluge, SABnzbd, Transmission gibi istemcilerin kuyruğunu ve hızını gösterir.
• Medya otomasyonu: Sonarr, Radarr, Lidarr gibi araçların takvimini ve bekleyen işlerini listeler.
• Ağ ve DNS: Pi-hole veya AdGuard Home için engellenen sorgu istatistiklerini sunar.
• Sistem izleme: CPU, RAM, disk ve ağ kullanımını gösteren sistem sağlığı widget'ları.
• Yardımcılar: Saat, hava durumu, takvim, RSS akışı ve not defteri gibi genel amaçlı kutucuklar.

Bir örnek üzerinden gidelim. Diyelim ki Pi-hole çalıştırıyorsunuz ve engellenen reklam sayısını panoda görmek istiyorsunuz. Önce Pi-hole yönetim arayüzünden bir API anahtarı alırsınız, sonra Homarr'da Pi-hole App'ini ekleyip iç adresini ve anahtarını girersiniz. Widget aktif olduğunda, panonuzda o gün engellenen sorgu yüzdesi ve toplam istek sayısı canlı biçimde görünür. Aynı mantık diğer tüm entegrasyonlar için geçerlidir: adres, tür ve anahtar. Bu üçlü doğru olduğunda widget veri akışına başlar.

Widget'ların bir güvenlik boyutu da vardır. Homarr, servis API'lerine sunucu tarafından bağlanır; yani anahtarlarınız tarayıcıya sızmaz. Yine de panele erişimi olan herkesin bu widget'ları göreceğini unutmayın. Hassas verileri gösteren kutucuklar barındırıyorsanız, ilerideki bölümde anlatacağım kimlik doğrulama ve reverse proxy önlemlerini mutlaka uygulayın.

Düzen Özelleştirme ve Sürükle Bırak Arayüzü#

Homarr'ın en keyifli yanı düzen özelleştirmesidir. Düzenleme moduna geçtiğinizde her kutucuğun köşesinde tutamaçlar belirir; kartı sürükleyip ızgara üzerinde istediğiniz konuma bırakır, kenarından tutup genişletir veya daraltırsınız. Izgara sistemi sayesinde kartlar birbirine güzelce hizalanır ve dağınık görünmezler. Bu yaklaşım, YAML dosyası düzenlemeye kıyasla çok daha sezgiseldir; değişikliği yaparken sonucu anında görürsünüz.

Kutucukları mantıklı bölmelere ayırmak için "Category" (kategori) ve "Dynamic Section" gibi düzen elemanlarını kullanabilirsiniz. Örneğin "Medya", "Ağ", "Yönetim" ve "İzleme" başlıklı kategoriler oluşturup ilgili servisleri altlarına toplayabilirsiniz. Böylece pano büyüdükçe bile bir düzen içinde kalır. Ayrıca birden fazla pano tanımlayabilir, farklı kullanıcı grupları veya farklı amaçlar için ayrı sayfalar tutabilirsiniz.

Görsel kişiselleştirme de oldukça esnektir. Ayarlardan tema rengini, arka planı, kartların saydamlığını ve köşe yuvarlaklığını değiştirebilirsiniz. Koyu ve açık tema arasında geçiş yapılabilir; hatta özel bir arka plan görseli tanımlayarak panoyu markanıza uygun hale getirebilirsiniz. Küçük bir işletme için sunucu panosunu şirket renkleriyle giydirmek, ekip için tanıdık ve profesyonel bir deneyim yaratır.

Bir pratik ipucu: Panonuzu tasarlarken en sık kullandığınız servisleri sol üste, seyrek kullandıklarınızı alta yerleştirin. Göz, sayfayı soldan sağa ve yukarıdan aşağıya tarar; önemli olanı öne almak günlük kullanımı hızlandırır. Durumu kritik servisler (örneğin yedekleme veya güvenlik duvarı) için ping'i açık tutmak da bir sorun çıktığında panoya bakar bakmaz fark etmenizi sağlar. Yedekleme stratejinizi bütünsel kurmak isterseniz yedekleme çözümlerimiz ve sunucu yönetimi hizmetimiz bu tarafı devralabilir.

Homarr ile Homepage Karşılaştırması#

Kendi sunucusunda pano çalıştırmak isteyenlerin sık karşılaştırdığı iki isim vardır: Homarr ve Homepage. İkisi de aynı problemi çözer ama felsefeleri farklıdır. Homepage, tamamen dosya tabanlı çalışır; düzeni, servisleri ve widget'ları YAML dosyalarına yazarsınız. Bu, sürüm kontrolü sevenler ve "her şey koda dökülsün" diyen yöneticiler için çok caziptir çünkü yapılandırmayı Git'te tutar, kopyalar ve otomatikleştirebilirsiniz. Homarr ise düzenlemeyi tarayıcıya taşır; teknik olmayan kullanıcılar bile fareyle pano kurabilir.

Hangisinin size uygun olduğu, önceliğinize bağlıdır. Aşağıdaki tablo iki aracın temel farklarını özetliyor:

Pratikte şöyle bir ayrım yapabilirsiniz. Panoyu ailenizle veya teknik olmayan bir ekiple paylaşacaksanız, birden çok kullanıcı tanımlayıp herkese kendi görünümünü vereceksiniz ve düzenlemeyi fare kullanarak yapmak istiyorsanız Homarr daha rahattır. Buna karşılık, tüm altyapınızı kod olarak (infrastructure as code) yönetiyor, panonuzu da bir depoda tutup birden çok sunucuya aynı yapılandırmayı dağıtmak istiyorsanız Homepage'in dosya tabanlı yapısı daha uygundur. İyi haber şu ki ikisi de ücretsiz ve açık kaynaktır; birini deneyip beğenmezseniz diğerine geçmek yalnızca birkaç saatlik bir iştir. Her iki uygulamayı da tek tıkla denemek isterseniz App Center üzerinden self-hosted uygulama seçeneklerimize göz atabilirsiniz.

Güvenlik, Reverse Proxy ve Yedekleme#

Homarr'ı sadece yerel ağınızda kullanacaksanız güvenlik tarafı görece basittir. Ancak panele internet üzerinden erişmek isterseniz, onu doğrudan bir portla dışarı açmak yerine bir reverse proxy arkasına almalı ve HTTPS ile şifrelemelisiniz. Nginx ile tipik bir yapılandırma şöyle görünür:

server {
    listen 443 ssl;
    server_name pano.ornek.com;

    ssl_certificate     /etc/letsencrypt/live/pano.ornek.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/pano.ornek.com/privkey.pem;

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

        # WebSocket desteği (canlı güncellemeler için)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Bu yapılandırmada Homarr yerelde 7575 portunda kapalı kalır; dışarıya yalnızca 443 üzerinden şifreli trafik çıkar. Alan adınızın DNS kaydını da doğru yönlendirmeyi unutmayın:

; A kaydı: alt alan adını sunucu IP'sine yönlendirin
pano    IN    A    203.0.113.10

Ücretsiz ve otomatik yenilenen bir sertifika için Let's Encrypt idealdir; kurumsal bir çözüm veya wildcard sertifika arıyorsanız SSL sertifikası sayfamız işinizi görür. Panonuzu internete açtığınız anda ek bir koruma katmanı olarak WAF ve DDoS koruma hizmetlerini değerlendirmenizi öneririm; herkese açık bir yönetim arayüzü, bot taramalarının ilk hedefi olur.

Yedekleme tarafı çok basittir ama ihmal edilmemelidir. Homarr'ın tüm yapılandırması, Compose dosyasında bağladığınız ./homarr/appdata dizinindedir. Bu klasörü düzenli yedeklerseniz, sunucu göçse bile panonuzu dakikalar içinde geri getirirsiniz:

# appdata dizinini tarih damgalı bir arşive alın
tar czf homarr-yedek-$(date +%F).tar.gz ~/homarr/appdata

# Geri yükleme: konteyneri durdurun, arşivi açın, tekrar başlatın
docker compose down
tar xzf homarr-yedek-2026-07-10.tar.gz -C ~/homarr
docker compose up -d

Bu yedeği güvenli bir yerde (ideal olarak sunucu dışında) saklamak, tüm self-hosted kurulumların altın kuralıdır. Otomatik ve dış konumda yedekleme için yedekleme hizmetimizi kullanabilir, tüm sunucunun bakımını profesyonel bir ekibe devretmek isterseniz sunucu yönetimi paketimizden faydalanabilirsiniz.

Sıkça Sorulan Sorular#

Homarr ücretsiz mi ve hangi lisansla dağıtılıyor?#

Homarr tamamen ücretsiz ve açık kaynaktır; kendi sunucunuzda herhangi bir lisans ücreti ödemeden çalıştırabilirsiniz. Kaynak kodu herkese açık olarak geliştirilir, dilerseniz katkıda bulunabilir veya kodu inceleyerek güvenlik açısından denetleyebilirsiniz. Bu yönüyle hem ev laboratuvarları hem de küçük işletmeler için maliyetsiz bir çözümdür.

Homarr'ı çalıştırmak için ne kadar sistem kaynağı gerekir?#

Homarr oldukça hafiftir ve düşük donanımlı sunucularda bile rahatça çalışır. Genellikle birkaç yüz megabayt RAM ve düşük bir CPU kullanımı yeterlidir; bir Raspberry Pi üzerinde bile sorunsuz döner. Yani mevcut sunucunuzda ayrı, güçlü bir makineye ihtiyaç duymadan yanına ekleyebilirsiniz. Küçük bir VDS veya sanal sunucu paketi bu iş için fazlasıyla yeterlidir.

Homarr servislerimi otomatik olarak bulabilir mi?#

Evet, Docker soketini salt-okunur olarak bağladığınızda Homarr çalışan konteynerlerinizi keşfedebilir ve etiketlerine göre kartları hazırlayabilir. Bu, elle her servisi tek tek eklemek yerine hızlı bir başlangıç sağlar. Yine de iç ve dış adres gibi bazı alanları gözden geçirmeniz, hatta canlı widget'lar için API anahtarı girmeniz gerekebilir.

Homarr ile Uptime Kuma arasındaki fark nedir?#

Homarr bir başlangıç panosudur ve öncelikli işi servislerinizi tek yerde toplayıp erişimi kolaylaştırmaktır; sunduğu durum noktası basit bir erişilebilirlik göstergesidir. Uptime Kuma ise özel olarak izleme için tasarlanmıştır; geçmişe dönük kesinti kaydı, bildirim kanalları ve SLA raporu sunar. İkisi rakip değil, tamamlayıcıdır; birçok kişi Homarr'ı vitrin, Uptime Kuma'yı ise arka plandaki izleme motoru olarak birlikte kullanır.

Panele internet üzerinden güvenle erişebilir miyim?#

Erişebilirsiniz, ancak Homarr'ı doğrudan bir portla dışarı açmak yerine bir reverse proxy arkasına almanız ve HTTPS ile şifrelemeniz gerekir. Ek olarak güçlü bir yönetici parolası belirlemeli, mümkünse WAF ve DDoS koruma gibi katmanlarla korumalısınız. Bu önlemler alındığında panonuza dünyanın her yerinden güvenle ulaşabilirsiniz.

Homarr'ı Portainer'ın yerine kullanabilir miyim?#

Hayır, çünkü ikisi farklı işler yapar. Portainer konteynerleri başlatmak, durdurmak, güncellemek ve loglarını incelemek gibi yönetim işlerine odaklanır; Homarr ise bu servislere erişimi ve genel görünürlüğü sadeleştiren bir vitrindir. En verimli kurulum, ikisini birlikte kullanmaktır: yönetimi Portainer'a, günlük erişimi Homarr'a bırakırsınız.

Kapanış#

Homarr, dağınık bir sunucuyu tek bir düzenli açılış sayfasına dönüştüren, kurulumu dakikalar süren ve öğrenmesi neredeyse hiç zaman almayan bir çözümdür. Sürükle bırak arayüzü sayesinde konfigürasyon dosyalarıyla boğuşmadan panonuzu kurar, canlı widget'lar sayesinde servislerinizin durumunu tek bakışta görür ve isterseniz onu markanıza uygun biçimde giydirirsiniz. Portainer ile yönetimi, Uptime Kuma ile izlemeyi birleştirdiğinizde ise elinizde tam teşekküllü, tamamen kendi kontrolünüzde bir kontrol merkezi olur.

Bu tür self-hosted uygulamaları sağlam bir zeminde çalıştırmak, deneyimin kalitesini doğrudan belirler. Homarr ve benzeri araçları barındırmak için hızlı ve güvenilir bir altyapı arıyorsanız sanal sunucu ve VDS paketlerimize, tam performanslı bir çözüm için sunucu seçeneklerimize göz atın. Web tabanlı projelerinizi barındırmak için hosting paketlerimiz, tek tıkla uygulama kurulumları için ise App Center tam size göre. Kurulumu ve bakımı bize bırakmak isterseniz sunucu yönetimi hizmetimizle yanınızdayız; siz panonuzu tasarlayın, altyapının geri kalanını Clou.TR üstlensin.