Aktualizacje

HolyArrs informuje cię o nowej wersji, ale nigdy sam jej nie instaluje. Nowy image pobierasz wtedy, kiedy ci pasuje.

Sprawdź, czy jest nowa wersja

1. Otwórz stronę Status (http://your-server:6262/health).
2. Przeczytaj sekcję Updates (aktualizacje). Zobaczysz jeden z tych komunikatów:

Komunikat	Znaczenie
“HolyArrs 1.2.0 is out, newer than this one.”	Zaktualizuj, kiedy ci pasuje
“This is the newest version.”	Nic do zrobienia
“No HolyArrs release is published yet.”	Kanał jest pusty. To nie błąd
“The last check did not work: …”	Nie udało się połączyć z kanałem, zwykle brak internetu
“The update check is off: …”	Wyłączone w Ustawieniach

3. Żeby zapytać od razu, kliknij Check now (sprawdź teraz) albo Check again (sprawdź ponownie). Potrzebujesz do tego uprawnienia Change settings (zmiana ustawień).

Nowsza wersja pojawia się też jako ostrzeżenie kondycji. Nieudane sprawdzenie widać tylko w sekcji Updates.

Aktualizacja

1. Pobierz nowy image i zrestartuj: docker compose pull, a potem docker compose up -d.
2. HolyArrs się uruchamia. Jeśli nowa wersja zmienia sposób zapisu danych, najpierw robi backup, a potem aktualizuje dane. Aplikacja powinna otworzyć się już w nowej wersji.

Wskazówka

Nieudany krok aktualizacji jest cofany, a HolyArrs zatrzymuje się na stronie, która mówi, co się stało. Twoje dane sprzed aktualizacji zostają jako backup.

Wróć do starszej wersji

HolyArrs nie może zmienić własnego image’u, więc uruchamiasz starszy image, a HolyArrs przywraca starsze dane.

Uwaga

Wszystko, co zmieniło się po aktualizacji, na przykład nowe tytuły, ustawienia i historia, nie ma tego w backupie sprzed aktualizacji.

1. Zmień tag image’u w pliku compose (albo w docker run) na starszy, na przykład holyarrs/holyarrs:<older version>.
2. Wykonaj docker compose up -d.
3. Jeśli aktualizacja nie zmieniła danych, starsza wersja się uruchomi. Gotowe.
4. W przeciwnym razie starsza wersja pokaże stronę zamiast aplikacji. Kliknij Put back the data from before the update (przywróć dane sprzed aktualizacji).
5. Wpisz kod jednorazowy. Znajdziesz go przez docker logs <container>; szukaj „one-time code“.
6. HolyArrs sprawdza backup, przywraca go i zatrzymuje się. Kontener powinien wystartować ponownie na tych danych dzięki polityce restartu. Bez niej uruchom go sam.

Bez tej strony: docker exec <container> /holyarrs restore --pre-update, a potem docker restart <container>. Bez Dockera: zatrzymaj HolyArrs, wykonaj holyarrs restore --pre-update i uruchom go.

Nic nie jest usuwane. Nowsze dane trafiają do backups/before-restore-<time>/, więc możesz to cofnąć. Przy powrocie o więcej niż jedną wersję wybierany jest najnowszy backup sprzed aktualizacji, który ta wersja potrafi odczytać.

Opcje

Wszystko w Settings > Health checks. Ostatnie trzy są w zaawansowanej części karty.

Ustawienie	Domyślnie	Zmień, gdy
Check for a newer HolyArrs (szukaj nowszej wersji HolyArrs)	Włączone	Nie chcesz żadnego zapytania na zewnątrz
Check for updates every (sprawdzaj aktualizacje co)	dzień	Chcesz rzadszych sprawdzeń: 3, 7, 14 lub 30 dni
Release feed (kanał wersji)	Pusty (wersje HolyArrs)	Hostujesz własny kanał
Feed may be on the local network (kanał może być w sieci lokalnej)	Wyłączone	Twój kanał jest w twojej sieci
Include test versions (like 1.2.0-rc1) (uwzględniaj wersje testowe)	Wyłączone	Chcesz dostawać powiadomienia o wersjach testowych

Jeśli to nie działa

Objaw: „The last check did not work.“ Przyczyna: serwer nie ma internetu albo twój własny kanał jest w sieci lokalnej. Rozwiązanie: sprawdź dostęp do internetu albo włącz Feed may be on the local network.

Objaw: kanał wersji nie chce się zapisać. Przyczyna: adres zawiera nazwę użytkownika, hasło, ?query lub #fragment albo nie zaczyna się od http:// ani https://. Rozwiązanie: usuń te części.

Objaw: aktualizacja zatrzymała się z braku miejsca na dysku. Przyczyna: brakuje miejsca na kopię i aktualizację. Rozwiązanie: zwolnij miejsce tam, gdzie leży folder konfiguracji, i uruchom ponownie.

Objaw: strona powrotu do starszej wersji odrzuca twój kod. Przyczyna: stary kod albo 10 błędnych kodów od ostatniego uruchomienia. Rozwiązanie: skopiuj kod z najnowszej linii logu. Po 10 błędnych próbach zrestartuj kontener i użyj nowego kodu.

Funkcje wstrzymane

Niektóre funkcje są w tej wersji domyślnie wyłączone. Włączasz je na własne ryzyko. Dopóki są wstrzymane, ich strony i pozycje menu są ukryte, ich trasy API odpowiadają „not found“, a ich zadania nie działają. Dane zapisane dla nich zostają.

Żeby włączyć funkcję, dodaj jej przełącznik do HOLYARRS_FLAGS, rozdzielając przecinkami, i zrestartuj kontener:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Usuń nazwę i zrestartuj, żeby wyłączyć. Ukryte ustawienia wracają po ponownym włączeniu.

Przełącznik	Funkcja
plex_watchlists	Listy Plex zamieniają się w prośby
row_title_stats	Statystyki tytułów w rzędach Explore, w Appearance
trakt_lists	Klucz Trakt, listy Trakt i recenzje Trakt. Listy TMDB zostają włączone
alert_channels_more	Powiadomienia przez Telegram, ntfy, Gotify, Pushover i webhook. Discord i e-mail zostają włączone
subtitle_sites	Serwisy z napisami i wyszukiwanie napisów. Twój język napisów zostaje włączony
emby_signin	Logowanie przez Emby. Odświeżanie biblioteki Emby nadal działa
go_back	Panel Go back na stronie Status. Kroki z sekcji Wróć do starszej wersji działają bez niego

Po dodaniu przełącznika nic się nie zmieniło? Sprawdź pisownię (małe litery, podkreślenia) i zrestartuj kontener, a nie tylko stronę.

Dla zaawansowanych

Co wysyła sprawdzanie

Jedno zapytanie do api.github.com o najnowszą wersję, z jedynym nagłówkiem User-Agent: HolyArrs/<version>. Bez konta, klucza i listy multimediów. Przy wyłączonym sprawdzaniu nie ma żadnych zapytań.

Ostatnia odpowiedź jest zapisywana, więc po restarcie sprawdzanie nie rusza przed czasem. Jedno sprawdzenie czeka najwyżej 15 s, czyta najwyżej 512 KB i obsługuje najwyżej 3 przekierowania, nigdy nie przełączając się między http a https. Link do notatek wersji pojawia się tylko wtedy, gdy wskazuje strony wersji HolyArrs na GitHubie; w innym razie wersja jest zwykłym tekstem.

Release feed przyjmuje odpowiedź w stylu GitHuba, listę wersji, dowolny JSON z polem version albo zwykły tekst z numerem wersji. Adresy metadanych chmury są zawsze odrzucane. Wersja testowa liczy się jako starsza od zwykłej wersji.

Backup przed aktualizacją

Zanim zmieni zapisane dane, HolyArrs:

1. Sprawdza, czy jest miejsce na kopię i aktualizację. Jeśli nie, nic nie zmienia. Pomiń to przez HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Kopiuje każdą bazę danych do backups, sprawdza kopię i zapisuje obok plik sha256. Po 3 nieudanych kopiach nic się nie zmienia.
3. Wykonuje każdy krok aktualizacji osobno i go sprawdza. Nieudany krok jest cofany; zakończone kroki zostają. Uruchom tę samą wersję jeszcze raz, żeby kontynuować od nieudanego kroku z tą samą kopią.

Po pierwszym udanym starcie kopia staje się plikiem holyarrs-backup-pre-update-<time>.zip, opisanym na przykład „before updating from 1.1.0 to 1.2.0“. Widać ją w Settings > Backups i w holyarrs restore --list. Trzy najnowsze są zachowywane; harmonogram backupów nigdy ich nie usuwa. Świeża instalacja albo aktualizacja, która nie dotyka danych, nie tworzy żadnej.

Powiązane strony

• Backupy
• Kontrole kondycji
• Moduły i tryb awaryjny