Yedekler

Kurulumunun bir kopyasını sakla. Kötü bir güncellemeden, bozulan bir diskten ya da yeni bir bilgisayara geçişten sonra geri yüklersin.

Başlamadan önce

• Settings > Backups (Ayarlar > Yedekler) için Change settings (ayarları değiştir) izni gerekir. Yalnızca sahip geri yükleyebilir.
• İndirme, silme ve geri yükleme için son birkaç dakika içinde parolayla giriş yapmış olman gerekir.

Yedek al

1. Settings > Backups’ı aç.
2. Back up now’a (şimdi yedekle) bas. Yeni yedeği Saved backups (kayıtlı yedekler) altında görmelisin.
3. Bir kopyayı sunucunun dışında tutmak için yanındaki Download’a (indir) bas.

Ana anahtarı kaydet

Yedekler ana anahtarı içermez. Ana anahtar, ayarlarındaki parolaları ve API anahtarlarını açar. Eşleşen anahtar olmadan, geri yüklenen bir yedek bunları okuyamaz.

1. Master key (ana anahtar) altında sahip Download key kit’e (anahtar paketini indir) basar.
2. Dosyayı sunucudan ve yedeklerinden ayrı bir yerde sakla. Anahtar paketi uyarısının Settings > Backups’tan ve sağlık denetimlerinden kalktığını görmelisin.

Sonra kullanmak için adını holyarrs.key yap ve yapılandırma klasörüne koy. Sahip değil misin? Sahipten indirmesini iste.

Yedeği geri yükle

Tehlike

Yedekten sonra yaptığın değişiklikler kaybolur. Önce eşleşen ana anahtarı hazırla.

1. Restore from a file’a (dosyadan geri yükle) bas ve bir HolyArrs yedek zip’i seç.
2. Onayla.
3. HolyArrs dosyayı denetler. Restore ready. It applies on the next start. yazısını görmelisin.
4. HolyArrs yeniden başlar ve yedeği yerine koyar. Önerilen Docker yeniden başlatma ilkesiyle bu kendiliğinden olur.

Mevcut veritabanların /config/backups/before-restore-<time> klasörüne taşınır, böylece geri yüklemeyi geri alabilirsin.

Seçenekler

Ne sıklıkta

Seçenek	Yedekler	Saklar
Balanced (dengeli, varsayılan)	Her gün	Son 7 gün ve 4 haftalık kopya
Light (hafif)	Haftada bir	4 hafta. En az yer kaplar
Careful (dikkatli)	Her gün	Her kopya 30 gün

En yeni zamanlanmış yedek her zaman saklanır. Bu kurallar yalnızca zamanlanmış yedekleri temizler. Kendi aldığın yedekler sen silene kadar durur (satırdaki çöp kutusu düğmesi; bu geri alınamaz). HolyArrs ayrıca saklanan verileri değiştiren bir güncellemeden önce yedek alır ve en yeni 3 tanesini tutar; bkz. Güncellemeler.

Yeni bir bilgisayara geç

Yeni kurulum ilk açılışta kendi ana anahtarını üretir. Bu anahtar eski yedeklerini açamaz, bu yüzden geri yükleme reddedilir. Önce eski anahtarı yerine koy. Örneklerde konteynerin adı holyarrs; sen kendi adını kullan.

1. İlk açılıştan önce konteyneri başlatmadan oluştur: docker compose create, ya da docker run satırında docker run -d yerine docker create.
2. Eski anahtarını içeri kopyala: docker cp holyarrs.key holyarrs:/config/. holyarrs.key adını verdiğin bir anahtar paketi de olur. Bu, adlandırılmış birim ya da host klasörü için çalışır; HolyArrs başlarken /config içindeki dosyaları PUID ve PGID kullanıcına devreder. HOLYARRS_MASTER_KEY_FILE kullanıyorsan anahtarı bunun yerine host’ta o yola koy; PUID ve PGID kullanıcın okuyabilmeli.
3. Yedeği geri yükle. Bir yol seç:

   • HolyArrs’ı başlat, ilk açılışı bitir, sonra Settings > Backups içindeki Restore from a file’ı kullan.

   • Ya da ilk açılıştan önce geri yükle. Zip’i adını değiştirmeden backups adlı bir klasöre koy ve docker cp backups holyarrs:/config/ ile içeri kopyala. Sonra aynı imajla geri yüklemeyi bir kez çalıştır:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Anahtar dosyası yolu kullanıyorsan -e HOLYARRS_MASTER_KEY_FILE=<its path> ekle; böylece geri yükleme senin anahtarına göre denetler. restore --list görebildiği yedeklerin adlarını gösterir.

4. HolyArrs’ı başlat. Kütüphaneni ve ayarlarını geri gelmiş görmelisin.

Anahtarı kopyalamadan yeni kurulumu mu başlattın? İçinde saklamaya değer bir şey yoksa HolyArrs’ı durdur, eski anahtarını aynı docker cp ile yenisinin üstüne kopyala, geri yükle, sonra başlat.

Çalışmazsa

Belirti: “Backups are off in this build”. Neden: bu kopya yedek yöneticisi olmadan çalışıyor. Çözüm: uygulamada çözüm yok; yedek denetimleri yok.

Belirti: İndirme, silme ya da geri yükleme parolanı soruyor. Neden: bunlar için yakın zamanda parolayla giriş gerekir. Çözüm: parolanla yeniden giriş yap ve tekrar dene.

Belirti: geri yükleme ana anahtar yüzünden reddediliyor. Neden: yapılandırma klasöründeki anahtar yedekle eşleşmiyor. Çözüm: eşleşen holyarrs.key dosyasını geri koy ve tekrar dene.

Geri yükleme ayrıca şu zip’leri de reddeder: çok büyük ya da bozuk olanlar, beklenmeyen dosya içerenler, daha yeni bir veritabanı sürümünden gelenler ve anahtarının okuyamadığı veri içerenler.

Uzmanlar için

Bir yedekte ne var

Her yedek bir zip’tir: ana veritabanı, varsa Events veritabanı ve backup.json (HolyArrs sürümü, veritabanı sürümleri, yedek türü, alınma zamanı). Medya, indirmeler, kapak görselleri, günlükler ve ana anahtar içinde yoktur.

İlk açılıştan önce geri yükleme

docker cp adlandırılmış birim ya da host klasörü için çalışır; HolyArrs başlarken /config içindeki dosyaları PUID ve PGID kullanıcına devreder. HOLYARRS_MASTER_KEY_FILE ile anahtarı bunun yerine o host yoluna koy; PUID ve PGID okuyabilmeli.

1. Zip’i adını değiştirmeden backups adlı bir klasöre koy ve içeri kopyala: docker cp backups holyarrs:/config/.
2. Aynı imajla geri yüklemeyi bir kez çalıştır:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Anahtar dosyası yolu kullanıyorsan -e HOLYARRS_MASTER_KEY_FILE=<its path> ekle; böylece geri yükleme senin anahtarına göre denetler.
4. HolyArrs’ı başlat.

restore --list görebildiği yedeklerin adlarını gösterir.

İlgili

• Güncellemeler
• Kurulum
• Sağlık denetimleri