Бекапи

Чувај копију свог подешавања да је можеш вратити после лошег ажурирања, покварног диска или селидбе на нови рачунар.

Пре него што почнеш

• Settings > Backups (Подешавања > Бекапи) тражи дозволу Change settings (промена подешавања). Враћа само власник.
• Преузимање, брисање и враћање траже пријаву лозинком из последњих неколико минута.

Направи бекап

1. Отвори Settings > Backups.
2. Кликни на Back up now (направи бекап одмах). Требало би да видиш нови бекап испод Saved backups (сачувани бекапи).
3. Кликни на Download (преузми) поред њега да копију држиш ван сервера.

Сачувај главни кључ

Бекапи никад не садрже главни кључ, који отвара лозинке и API кључеве у твојим подешавањима. Без одговарајућег кључа враћени бекап не може да их прочита.

1. Испод Master key (главни кључ) власник кликне на Download key kit (преузми пакет кључа).
2. Држи фајл даље од сервера и одвојено од бекапа. Требало би да видиш како упозорење о пакету кључа нестаје из Settings > Backups и из провера исправности.

Да га касније користиш, преименуј га у holyarrs.key и стави у конфигурациони фолдер. Ниси власник? Замоли власника да га преузме.

Врати бекап

Danger

Измене направљене после бекапа се губе. Прво припреми одговарајући главни кључ.

1. Кликни на Restore from a file (врати из фајла) и изабери HolyArrs бекап zip.
2. Потврди.
3. HolyArrs проверава фајл. Требало би да видиш Restore ready. It applies on the next start. (враћање је спремно, примењује се при следећем покретању).
4. HolyArrs се поново покрене и стави бекап на место. Са препорученом политиком поновног покретања у Docker-у то се дешава само од себе.

Твоје тренутне базе података се премештају у /config/backups/before-restore-<time>, па враћање можеш поништити.

Опције

Колико често

Опција	Бекап	Чува
Balanced (уравнотежено, подразумевано)	Сваки дан	Последњих 7 дана и 4 недељне копије
Light (лагано)	Једном недељно	4 недеље. Најмање простора
Careful (пажљиво)	Сваки дан	Сваку копију 30 дана

Најновији заказани бекап се увек чува. Ова правила чисте само заказане бекапе. Бекапи које сам направиш остају док их не обришеш (дугме са кантом на реду; ово се не може поништити). HolyArrs прави бекап и пре ажурирања које мења сачуване податке и чува најновија 3; погледај Ажурирања.

Пребаци на нови рачунар

Нова инсталација при првом покретању прави свој главни кључ. Тај кључ не може да отвори твоје старе бекапе, па се враћање одбија. Прво стави стари кључ на место. У примерима се контејнер зове holyarrs; користи своје име.

1. Пре првог покретања креирај контејнер без покретања: docker compose create, или свој docker run ред са docker create уместо docker run -d.
2. Копирај стари кључ унутра: docker cp holyarrs.key holyarrs:/config/. Пакет кључа преименован у holyarrs.key такође ради. Ово ради за именовани волумен или фолдер на хосту; HolyArrs при покретању даје фајлове у /config твом PUID и PGID. Ако користиш HOLYARRS_MASTER_KEY_FILE, стави кључ на ту путању на хосту, читљив за твој PUID и PGID.
3. Врати бекап. Изабери један начин:

   • Покрени HolyArrs, заврши прво покретање, па користи Restore from a file у Settings > Backups.

   • Или врати пре првог покретања. Стави zip, непромењеног имена, у фолдер backups и копирај га унутра са docker cp backups holyarrs:/config/. Затим једном изврши враћање са истом сликом контејнера:

     • 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>

     Ако користиш путању до фајла кључа, додај -e HOLYARRS_MASTER_KEY_FILE=<its path> да враћање проверава према твом кључу. restore --list показује имена бекапа која види.

4. Покрени HolyArrs. Требало би да видиш своју библиотеку и подешавања назад.

Нова инсталација је већ покренута пре копирања кључа? Ако на њој нема ничег вредног, заустави HolyArrs, копирај стари кључ преко новог истим docker cp, врати бекап, па покрени.

Ако не ради

Симптом: „Backups are off in this build“ (бекапи су искључени у овој верзији). Узрок: ова копија ради без менаџера бекапа. Решење: нема решења у апликацији; нема контрола за бекап.

Симптом: преузимање, брисање или враћање тражи лозинку. Узрок: за ово је потребна скорашња пријава лозинком. Решење: пријави се поново лозинком и покушај опет.

Симптом: враћање је одбијено због главног кључа. Узрок: кључ у конфигурационом фолдеру не одговара бекапу. Решење: врати одговарајући holyarrs.key и покушај поново.

Враћање одбија и zip који је превелик или оштећен, садржи неочекиване фајлове, долази из новије верзије базе података или садржи податке које твој кључ не може да прочита.

За напредне

Шта је у бекапу

Сваки бекап је zip са главном базом података, базом Events ако постоји, и backup.json (верзија HolyArrs, верзије база, врста бекапа, време прављења). Медији, преузимања, слике, логови и главни кључ нису у њему.

Враћање пре првог покретања

docker cp ради за именовани волумен или фолдер на хосту; HolyArrs при покретању даје фајлове у /config твом PUID и PGID. Са HOLYARRS_MASTER_KEY_FILE стави кључ на ту путању на хосту, читљив за PUID и PGID.

1. Стави zip, непромењеног имена, у фолдер backups и копирај га унутра: docker cp backups holyarrs:/config/.
2. Једном изврши враћање са истом сликом контејнера:
   • 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. Ако користиш путању до фајла кључа, додај -e HOLYARRS_MASTER_KEY_FILE=<its path> да враћање проверава према твом кључу.
4. Покрени HolyArrs.

restore --list показује имена бекапа која види.

Повезане странице

• Ажурирања
• Инсталација
• Провере исправности