Güncellemeler

HolyArrs yeni bir sürüm çıktığında sana haber verir ama onu asla kendisi kurmaz. Yeni imajı sana uygun olduğunda sen çekersin.

Yeni sürüm çıkmış mı bak

1. Status (Durum) sayfasını aç (http://your-server:6262/health).
2. Updates (Güncellemeler) bölümünü oku. Şunlardan birini görmelisin:

Mesaj	Anlamı
“HolyArrs 1.2.0 is out, newer than this one.”	Hazır olunca güncelle
“This is the newest version.”	Yapılacak bir şey yok
“No HolyArrs release is published yet.”	Feed boş. Bir sorun yok
“The last check did not work: …”	Feed’e ulaşılamadı, genelde internet yok
“The update check is off: …”	Ayarlarda kapatılmış

3. Hemen sormak için Check now (şimdi denetle) ya da Check again (tekrar denetle) düğmesine bas. Bunun için Change settings (ayarları değiştir) iznin olmalı.

Daha yeni bir sürüm sağlık uyarısı olarak da görünür. Başarısız bir denetim yalnızca Updates altında görünür.

Güncelle

1. Yeni imajı çek ve yeniden başlat: docker compose pull, sonra docker compose up -d.
2. HolyArrs başlar. Yeni sürüm verilerin saklanma şeklini değiştiriyorsa önce yedek alır, sonra verileri günceller. Uygulamanın yeni sürümle açıldığını görmelisin.

İpucu

Başarısız bir güncelleme adımı geri alınır ve HolyArrs, ne olduğunu söyleyen bir sayfada durur. Güncellemeden önceki verilerin yedek olarak kalır.

Eski sürüme dön

HolyArrs kendi imajını değiştiremez. Bu yüzden eski imajı sen çalıştırırsın, HolyArrs da eski verileri geri yükler.

Dikkat

Güncellemeden sonra değişen her şey, örneğin yeni başlıklar, ayarlar ve geçmiş, güncelleme öncesi yedeğin içinde değildir.

1. Compose dosyanda (ya da docker run komutunda) imaj etiketini eski olanla değiştir, örneğin holyarrs/holyarrs:<older version>.
2. docker compose up -d komutunu çalıştır.
3. Güncelleme verileri değiştirmediyse eski sürüm başlar. İş bitti.
4. Değiştirdiyse eski sürüm uygulama yerine bir sayfa gösterir. Put back the data from before the update (güncellemeden önceki verileri geri yükle) düğmesini seç.
5. Tek kullanımlık kodu yaz. Kodu docker logs <container> ile bul; “one-time code” geçen satıra bak.
6. HolyArrs yedeği kontrol eder, yerine koyar ve durur. Konteynerin yeniden başlatma ilkesi sayesinde bu veriyle tekrar başladığını görmelisin. İlke yoksa kendin başlat.

Sayfa olmadan: docker exec <container> /holyarrs restore --pre-update, sonra docker restart <container>. Docker olmadan: HolyArrs’ı durdur, holyarrs restore --pre-update komutunu çalıştır, tekrar başlat.

Hiçbir şey silinmez. Daha yeni sürümün verileri backups/before-restore-<time>/ klasörüne taşınır, böylece geri alabilirsin. Birden fazla sürüm geriye gidersen, o sürümün okuyabildiği en yeni güncelleme öncesi yedek seçilir.

Seçenekler

Hepsi Settings > Health checks (Ayarlar > Sağlık denetimleri) içinde. Son üçü kartın gelişmiş kısmında durur.

Ayar	Varsayılan	Ne zaman değiştirmeli
Check for a newer HolyArrs (daha yeni HolyArrs var mı diye bak)	Açık	Dışarıya hiç istek gitsin istemiyorsan
Check for updates every (güncellemeleri şu sıklıkla denetle)	günde bir	Daha seyrek denetim istiyorsan: 3, 7, 14 ya da 30 gün
Release feed (sürüm feed’i)	Boş (HolyArrs sürümleri)	Kendi feed’ini barındırıyorsan
Feed may be on the local network (feed yerel ağda olabilir)	Kapalı	Feed’in kendi ağında duruyorsa
Include test versions (like 1.2.0-rc1) (test sürümlerini dahil et)	Kapalı	Test sürümleri için bildirim istiyorsan

Çalışmazsa

Belirti: “The last check did not work.” Neden: sunucuda internet yok ya da kendi feed’in yerel ağda. Çözüm: internet erişimini kontrol et ya da Feed may be on the local network ayarını aç.

Belirti: sürüm feed’i kaydedilmiyor. Neden: adreste ad, parola, ?query ya da #fragment var, ya da adres http:// veya https:// ile başlamıyor. Çözüm: bu kısımları kaldır.

Belirti: güncelleme disk alanı yetmediği için durdu. Neden: kopya ve güncelleme için yer yok. Çözüm: yapılandırma klasörünün durduğu yerde alan aç, sonra yeniden başlat.

Belirti: geri dönme sayfası kodunu kabul etmiyor. Neden: eski bir kod, ya da son başlatmadan beri 10 yanlış kod. Çözüm: kodu en yeni günlük satırından kopyala. 10 yanlış denemeden sonra konteyneri yeniden başlat ve yeni kodu kullan.

Bekletilen özellikler

Bazı özellikler bu sürümde varsayılan olarak kapalıdır. Kendi sorumluluğunda açabilirsin. Bekletilirken sayfaları ve menü öğeleri gizlenir, API yolları “not found” yanıtı verir ve işleri çalışmaz. Onlar için kaydettiğin veriler durur.

Birini açmak için anahtarını HOLYARRS_FLAGS içine virgülle ayırarak ekle ve konteyneri yeniden başlat:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Kapatmak için adı sil ve yeniden başlat. Gizlenen ayarlar, tekrar açınca geri gelir.

Anahtar	Özellik
plex_watchlists	Plex izleme listeleri isteklere dönüşür
row_title_stats	Appearance içinde Explore satırı başlık istatistikleri
trakt_lists	Trakt anahtarı, Trakt listeleri ve Trakt incelemeleri. TMDB listeleri açık kalır
alert_channels_more	Telegram, ntfy, Gotify, Pushover ve webhook uyarıları. Discord ve e-posta açık kalır
subtitle_sites	Altyazı siteleri ve altyazı arama. Altyazı dilin açık kalır
emby_signin	Emby ile giriş. Emby Kütüphane yenilemesi yine çalışır
go_back	Status sayfasındaki Go back (eski sürüme dön) paneli. Eski sürüme dön altındaki adımlar bu olmadan da çalışır

Anahtar ekledin ama bir şey değişmedi mi? Yazımı kontrol et (küçük harf, alt çizgi) ve yalnızca sayfayı değil konteyneri yeniden başlat.

Uzmanlar için

Denetim neyi gönderir

En yeni sürüm için api.github.com adresine tek bir istek gider ve yalnızca User-Agent: HolyArrs/<version> içerir. Hesap, anahtar ya da medya listesi yok. Denetim kapalıyken hiç istek gitmez.

Son yanıt kaydedilir, bu yüzden yeniden başlatınca, vakti gelmeden yeni denetim yapılmaz. Bir denetim en fazla 15 sn bekler, en fazla 512 KB okur ve en fazla 3 yönlendirmeyi izler; http ile https arasında asla geçiş yapmaz. Sürüm notları bağlantısı yalnızca GitHub’daki HolyArrs sürüm sayfalarına gidiyorsa gösterilir; yoksa sürüm düz metin olarak görünür.

Release feed GitHub tarzı bir sürüm yanıtını, bir sürüm listesini, version içeren herhangi bir JSON’u ya da sürümü içeren düz metni kabul eder. Bulut metadata adresleri her zaman reddedilir. Test sürümü, düz sürümden eski sayılır.

Güncellemeden önceki yedek

Saklanan verileri değiştirmeden önce HolyArrs şunları yapar:

1. Bir kopya ve güncelleme için yer olup olmadığına bakar. Yoksa hiçbir şey değişmez. HOLYARRS_SKIP_SPACE_CHECK=yes ile atlanabilir.
2. Her veritabanını backups klasörüne kopyalar, kopyayı kontrol eder ve yanına bir sha256 dosyası yazar. 3 kopya başarısız olursa hiçbir şey değişmez.
3. Her güncelleme adımını ayrı çalıştırır ve kontrol eder. Başarısız adım geri alınır; biten adımlar kalır. Aynı sürümü yeniden başlatırsan, aynı kopyayla başarısız adımdan devam eder.

İlk başarılı başlatmadan sonra kopya holyarrs-backup-pre-update-<time>.zip olur ve “before updating from 1.1.0 to 1.2.0” gibi bir açıklaması olur. Settings > Backups (Ayarlar > Yedekler) içinde ve holyarrs restore --list çıktısında görünür. En yeni 3 tanesi saklanır; yedekleme zamanlaması bunları asla silmez. Sıfırdan kurulum ya da verilere dokunmayan bir güncelleme yedek oluşturmaz.

İlgili

• Yedekler
• Sağlık denetimleri
• Modüller ve güvenli mod