AFFiNE self-host etmeden önce: yedek, güncelleme ve geri dönüş planı

[[Kurulum yazısında]] self-host'un ne kazandırdığını anlattık.

Bu bölüm daha sıkıcı ama daha önemli:

**Sunucu kurulduktan sonra ne olacak?**

1. Kalıcı veriyi tanımla

İlk iş "hangi container çalışıyor?" sorusu değil.

Şunu yaz:

• veritabanı nerede,
• yüklenen dosyalar/blobs nerede,
• hangi volume kalıcı,
• environment sırları nerede,
• hangi dosyalar yeniden üretilebilir.

Bir Docker container'ı silinince içerik de gidiyorsa kalıcılık planı eksiktir.

Resmî self-host dokümanı güncel deployment ve backup ayrıntılarının dokümantasyonda tutulduğunu belirtiyor. Canlı compose dosyasını ve volume tanımlarını oradan takip et.

2. Yedek ile restore'u ayır

Bir klasörü her gece başka diske kopyalamak yedek olabilir.

Fakat geri yükleyemiyorsan operasyon planı değildir.

En az bir kez test et:

1. yeni boş ortam aç,
2. yedeği yükle,
3. AFFiNE'i başlat,
4. birkaç dokümanı aç,
5. ekleri kontrol et,
6. mümkünse ayrı istemciden senkronizasyonu dene.

Restore testi yapılmamış yedek, varsayımdır.

3. Upgrade'i olay haline getir

Yeni sürüm geldiğinde otomatik olarak "latest" çekmek rahat görünür.

Bilgi sistemi için risklidir.

Daha iyi sıra:

1. sürüm notunu oku,
2. breaking change var mı kontrol et,
3. mevcut sürümü kaydet,
4. yedek al,
5. upgrade yap,
6. smoke test uygula,
7. sorun varsa rollback kararı ver.

AFFiNE 0.27 bunun neden gerekli olduğunu gösteriyor.

Resmî Temmuz 2026 notuna göre **0.27 server yalnız 0.26 veya üzeri client ile bağlantı ve sync destekliyor.**

Yani yalnız sunucuyu güncellemek bazı eski istemcileri uyumsuz bırakabilir.

4. İstemcileri envantere al

Self-host AFFiNE yalnız server değildir.

Kullanıcılar şunlardan bağlanabilir:

• web,
• Windows/macOS/Linux masaüstü,
• iOS,
• Android.

Upgrade öncesinde hangi cihazlarda hangi istemci sürümünün bulunduğunu bilmek, özellikle ekip kullanımında önemlidir.

Tek kişilik sistemde bile eski dizüstü bilgisayarda kalan client sonradan şaşırtabilir.

5. Uptime ve kapasiteyi izle

Başlangıç için tam observability platformuna ihtiyacın yok.

En azından:

• sunucu erişilebilir mi,
• disk ne kadar dolu,
• container sürekli restart ediyor mu,
• yedek son ne zaman başarıyla alındı

sorularını görebil.

Sunucu kapanırsa ilk kez log okumaya başlamak geç kalmış operasyondur.

6. TLS ve domain

Kendi domain'in üzerinden erişiyorsan TLS sertifikasının yenilenmesi de sistemin parçasıdır.

Reverse proxy veya certificate automation kullanabilirsin; AFFiNE'in hangi reverse proxy'yi zorunlu tuttuğunu varsayma.

Burada hedef ürün seçmek değil:

**sertifika yenilenmesinin insan hafızasına bağlı olmaması.**

7. Geri dönüş noktasını belirle

Upgrade'den sonra sorun çıktığında üç seçeneğin olabilir:

• yeni sürümde düzeltmek,
• önceki sürüme dönmek,
• yedekten restore etmek.

Hangisinin mümkün olduğu veri migrasyonlarına bağlıdır.

AFFiNE'in 2024 data upgrade sorun giderme yazısı, geçmişte sürüm geçişlerinin veri kurtarma ihtiyacı doğurabildiğini gösteriyor. Bu yazı 2026 için doğrudan prosedür değildir; tarihsel risk kanıtıdır.

Bu yüzden upgrade'den önce güncel sürüm dokümanını kontrol et.

8. Aylık mini operasyon kontrolü

Ayda bir şu sekiz satır yeter:

• [ ] AFFiNE sürümü kayıtlı
• [ ] son yedek başarılı
• [ ] bir restore testi son 90 günde yapıldı
• [ ] disk kapasitesi yeterli
• [ ] TLS geçerli
• [ ] istemci sürümleri uyumlu
• [ ] kritik log hatası yok
• [ ] güncel release note okundu

Küçük sistem için bu kadar bile büyük fark yaratır.

Ne zaman Cloud'a dönmek daha doğru?

Self-host bir kimlik meselesi değil.

Şunlardan üçü aynı anda doğruysa Cloud tekrar değerlendirilebilir:

• yedekleri sürekli erteliyorsun,
• güncellemeler aylarca kalıyor,
• sunucu problemlerini çözmek istemiyorsun,
• sistem tek kişi için kullanılıyor,
• veri yerleşimi konusunda zorunluluğun yok.

Teknik olarak kurabilmek, işletmenin doğru olduğu anlamına gelmez.

Karar

AFFiNE self-host'un gerçek maliyeti VPS faturası değil.

**Sahiplik.**

Sunucu sende ise:

• veri sende,
• kontrol sende,
• bakım da sende.

Bu üçlü birlikte kabul ediliyorsa self-host doğru seçenektir.