AFFiNE self-host: Docker ile kendi sunucunda çalıştırmak ne kazandırır?

Self-host kulağa basit geliyor:

"Uygulamayı kendi sunucuma kurarım."

Gerçekte bu karar iki parçadan oluşuyor:

1. yazılımı çalıştırmak,
2. onu güvenilir biçimde işletmek.

İlk parça Docker ile oldukça erişilebilir olabilir. İkinci parça ise yedekleme, güncelleme, izleme ve geri dönüş planı gerektirir.

Güncel resmî yol

AFFiNE'in 7 Temmuz 2026 güncellenmiş self-host sayfası üç deployment yolu listeliyor:

• Docker Compose — önerilen yol,
• kendi cluster/orchestration yapın,
• ileride yönetilen hosting ortakları.

Kişisel veya küçük ekip kurulumu için başlangıç noktası açık: **Docker Compose.**

Resmî sayfa süreci yüksek seviyede üç adıma indiriyor:

1. Docker kur,
2. resmî deployment yapılandırmasını ve environment değişkenlerini hazırla,
3. stack'i başlat ve ilk hesabı oluştur.

Nitorel bu yazıda canlı komutları kopyalamıyor. Çünkü kurulum parametreleri değişebilir; güncel compose dosyası her zaman resmî dokümandan alınmalı.

Self-host sana ne verir?

Veri konumu

Sunucu ve storage nerede çalışacak, sen seçersin.

Bu kişisel kullanıcı için tercih olabilir; kurum için veri yerleşimi veya iç politika gereksinimi olabilir.

Upgrade kontrolü

Yeni sürüm çıktığı anda geçmek zorunda değilsin.

Önce yedek alabilir, sürüm notunu okuyabilir ve bakım penceresi belirleyebilirsin.

Yedek politikası

Yedeğin sıklığını, saklama süresini ve nerede tutulacağını sen belirlersin.

Bu esneklik ancak gerçekten yedek alıyorsan avantajdır.

Entegrasyon alanı

Kendi ağında reverse proxy, monitoring, kimlik doğrulama politikaları veya başka servislerle birlikte çalıştırabilirsin.

Burada her entegrasyonun AFFiNE tarafından resmen desteklendiğini varsayma. Ürün dokümanı neyi doğruluyorsa onunla sınırlı kal.

Sana ne yükler?

Self-host ile birlikte şu soruların sahibi olursun:

• Disk dolarsa kim fark edecek?
• Veritabanı bozulursa geri dönüş var mı?
• Upgrade başarısız olursa eski sürüme nasıl döneceksin?
• TLS sertifikası yenilenmezse ne olacak?
• Yedek gerçekten restore edilebiliyor mu?
• Sunucu kapalıyken ekip ne yapacak?

Bunların cevabı "Docker yeniden başlar" değildir.

Eski Docker rehberi neden tehlikeli?

AFFiNE'in "Self-host AFFiNE with Docker - 2023.01" sayfası bugün hâlâ aramada çıkıyor.

Ama sayfanın kendi güncelleme notu açık: bu rehber Ocak 2023 rollout'unu anlatıyor ve güncel deployment seçenekleri için yeni self-host merkezine yönlendiriyor.

Eski rehberde geçen:

• image tag'leri,
• klasör yolları,
• pre-alpha/alpha ayrımları,
• o dönemin server davranışı

2026 kurulumu için otorite kabul edilmemeli.

Bu yalnız AFFiNE'e özgü bir sorun değil. Self-host ürünlerde eski blog yazısı, güncel dokümantasyonun önüne geçtiğinde yanlış kurulum riski doğar.

Lisans notu

Güncel AFFiNE About sayfası önemli bir ayrım yapıyor: editör açık kaynakken backend tarafında AFFiNE Enterprise Edition lisans koşullarının bulunduğunu belirtiyor.

Bu yüzden "açık kaynak = bütün sunucu kodunu istediğim gibi değiştirip dağıtırım" varsayımı yapma.

Kişisel kullanım, kaynak kodu inceleme, ticari dağıtım veya backend modifikasyonu gibi senaryolarda güncel lisans metnini ayrıca kontrol et.

Kimin için mantıklı?

Self-host şu durumda anlamlı:

• sunucu yönetimi zaten yaptığın bir işse,
• veri konumu önemliyse,
• yedek ve monitoring altyapın varsa,
• Cloud bağımlılığını azaltmak istiyorsan,
• sistemin çalışmamasının sorumluluğunu üstlenebiliyorsan.

Şu durumda gereksiz olabilir:

• tek ihtiyacın kişisel not almaksa,
• Docker'ı ilk kez yalnız bu uygulama için kuracaksan,
• yedek planın yoksa,
• güncellemeleri takip etmeyeceksen.

Minimum doğru kurulum düşüncesi

AFFiNE'i production benzeri biçimde self-host edeceksen en az şunları planla:

• kalıcı storage,
• veritabanı yedeği,
• dosya/blob yedeği,
• domain + TLS,
• sürüm sabitleme,
• upgrade öncesi snapshot/yedek,
• basit uptime kontrolü,
• restore testi.

Bunlar olmadan çalışan container vardır; güvenilir sistem yoktur.

Karar

AFFiNE self-host, veri kontrolü isteyen kullanıcıya gerçek bir seçenek sunuyor. Güncel resmî yol Docker Compose.

Fakat doğru soru:

"Kurabilir miyim?" değil.

**"Bunu altı ay boyunca güvenilir biçimde işletebilir miyim?"**

Cevap evetse self-host güçlü bir rota. Değilse AFFiNE Cloud operasyon yükünü satın aldığın hizmettir.