Ενημερώσεις

Το HolyArrs σε ειδοποιεί όταν βγει νέα έκδοση και δεν την εγκαθιστά ποτέ μόνο του. Τραβάς τη νέα image όταν σε βολεύει.

Δες αν βγήκε νέα έκδοση

1. Άνοιξε τη σελίδα Status (Κατάσταση) (http://your-server:6262/health).
2. Διάβασε το Updates (ενημερώσεις). Θα πρέπει να δεις ένα από αυτά:

Μήνυμα	Τι σημαίνει
“HolyArrs 1.2.0 is out, newer than this one.”	Βγήκε νεότερη έκδοση. Ενημέρωσε όταν είσαι έτοιμος
“This is the newest version.”	Δεν χρειάζεται κάτι
“No HolyArrs release is published yet.”	Το feed είναι άδειο. Δεν φταίει κάτι
“The last check did not work: …”	Δεν έγινε επαφή με το feed, συνήθως επειδή δεν υπάρχει internet
“The update check is off: …”	Είναι απενεργοποιημένος στις Ρυθμίσεις

3. Για να ρωτήσεις τώρα, πάτησε Check now (έλεγχος τώρα) (ή Check again, έλεγχος ξανά). Χρειάζεται το δικαίωμα Change settings (αλλαγή ρυθμίσεων).

Μια νεότερη έκδοση εμφανίζεται και ως προειδοποίηση υγείας. Ένας έλεγχος που απέτυχε φαίνεται μόνο κάτω από το Updates.

Ενημέρωση

1. Τράβηξε τη νέα image και κάνε επανεκκίνηση: docker compose pull και μετά docker compose up -d.
2. Το HolyArrs ξεκινά. Αν η νέα έκδοση αλλάζει τον τρόπο αποθήκευσης των δεδομένων, κάνει πρώτα αντίγραφο ασφαλείας και μετά ενημερώνει τα δεδομένα. Θα πρέπει να δεις την εφαρμογή να ανοίγει στη νέα έκδοση.

Συμβουλή

Ένα βήμα ενημέρωσης που απέτυχε αναιρείται και το HolyArrs σταματά σε μια σελίδα που λέει τι έγινε. Τα δεδομένα σου από πριν την ενημέρωση μένουν ως αντίγραφο ασφαλείας.

Επιστροφή στην προηγούμενη έκδοση

Το HolyArrs δεν μπορεί να αλλάξει τη δική του image, οπότε τρέχεις εσύ την παλιότερη image και το HolyArrs επαναφέρει τα παλιότερα δεδομένα.

Προσοχή

Ό,τι άλλαξε μετά την ενημέρωση, όπως νέοι τίτλοι, ρυθμίσεις και ιστορικό, δεν υπάρχει στο αντίγραφο ασφαλείας πριν από την ενημέρωση.

1. Άλλαξε το tag της image στο αρχείο compose σου (ή στο docker run) σε αυτό της παλιότερης έκδοσης, για παράδειγμα holyarrs/holyarrs:<older version>.
2. Τρέξε docker compose up -d.
3. Αν η ενημέρωση δεν είχε αλλάξει τα δεδομένα, ξεκινά η παλιότερη έκδοση. Τελείωσες.
4. Αλλιώς η παλιότερη έκδοση δείχνει μια σελίδα αντί για την εφαρμογή. Πάτησε Put back the data from before the update (επαναφορά των δεδομένων από πριν την ενημέρωση).
5. Γράψε τον κωδικό μίας χρήσης. Θα τον βρεις με docker logs <container>· ψάξε για “one-time code”.
6. Το HolyArrs ελέγχει το αντίγραφο ασφαλείας, το βάζει στη θέση του και σταματά. Θα πρέπει να δεις το container να ξεκινά ξανά πάνω σε αυτά τα δεδομένα μέσω της πολιτικής επανεκκίνησής του. Αν δεν έχει, ξεκίνα το με το χέρι.

Χωρίς τη σελίδα: docker exec <container> /holyarrs restore --pre-update και μετά docker restart <container>. Χωρίς Docker: σταμάτα το HolyArrs, τρέξε holyarrs restore --pre-update και ξεκίνα το.

Τίποτα δεν διαγράφεται. Τα νεότερα δεδομένα πάνε στο backups/before-restore-<time>/, ώστε να μπορείς να το αναιρέσεις. Αν γυρίσεις πίσω πάνω από μία έκδοση, επιλέγεται το πιο πρόσφατο αντίγραφο πριν από ενημέρωση που μπορεί να διαβάσει εκείνη η έκδοση.

Επιλογές

Όλες βρίσκονται στο Settings > Health checks (Ρυθμίσεις > Έλεγχοι υγείας). Οι τελευταίες τρεις είναι στο προχωρημένο μέρος της κάρτας.

Ρύθμιση	Προεπιλογή	Άλλαξέ την όταν
Check for a newer HolyArrs (έλεγχος για νεότερο HolyArrs)	Ενεργό	Δεν θέλεις κανένα εξωτερικό αίτημα
Check for updates every (έλεγχος ενημερώσεων κάθε)	ημέρα	Θέλεις λιγότερους ελέγχους: 3, 7, 14 ή 30 ημέρες
Release feed (feed εκδόσεων)	Άδειο (εκδόσεις του HolyArrs)	Φιλοξενείς δικό σου feed
Feed may be on the local network (το feed μπορεί να είναι στο τοπικό δίκτυο)	Ανενεργό	Το feed σου είναι στο δικό σου δίκτυο
Include test versions (like 1.2.0-rc1) (να περιλαμβάνονται δοκιμαστικές εκδόσεις)	Ανενεργό	Θέλεις ειδοποιήσεις για δοκιμαστικές εκδόσεις

Αν δεν δουλεύει

Σύμπτωμα: “The last check did not work.” Αιτία: ο διακομιστής δεν έχει internet, ή το δικό σου feed είναι στο τοπικό δίκτυο. Λύση: έλεγξε την πρόσβαση στο internet, ή ενεργοποίησε το Feed may be on the local network.

Σύμπτωμα: το feed εκδόσεων δεν αποθηκεύεται. Αιτία: η διεύθυνση έχει όνομα χρήστη, κωδικό, ?query ή #fragment, ή δεν ξεκινά με http:// ή https://. Λύση: αφαίρεσε αυτά τα μέρη.

Σύμπτωμα: η ενημέρωση σταμάτησε λόγω έλλειψης χώρου στον δίσκο. Αιτία: δεν υπάρχει χώρος για το αντίγραφο και την ενημέρωση. Λύση: άδειασε χώρο εκεί που βρίσκεται ο φάκελος ρυθμίσεων και ξεκίνα ξανά.

Σύμπτωμα: η σελίδα επιστροφής δεν δέχεται τον κωδικό σου. Αιτία: παλιός κωδικός, ή 10 λάθος κωδικοί από την τελευταία εκκίνηση. Λύση: αντίγραψε τον κωδικό από την πιο πρόσφατη γραμμή του αρχείου καταγραφής (log). Μετά από 10 λάθος προσπάθειες, κάνε επανεκκίνηση στο container και χρησιμοποίησε τον νέο κωδικό.

Κρατημένες λειτουργίες

Μερικές λειτουργίες είναι κλειστές από προεπιλογή σε αυτή την έκδοση. Ενεργοποίησέ τες με δική σου ευθύνη. Όσο είναι κρατημένες, οι σελίδες και τα στοιχεία μενού τους είναι κρυμμένα, οι διαδρομές API τους απαντούν “not found” και οι εργασίες τους δεν τρέχουν. Τα δεδομένα που έχεις αποθηκεύσει γι’ αυτές μένουν.

Για να ενεργοποιήσεις μία, πρόσθεσε τον διακόπτη της στο HOLYARRS_FLAGS, χωρισμένους με κόμμα, και κάνε επανεκκίνηση στο container:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Αφαίρεσε το όνομα και κάνε επανεκκίνηση για να την απενεργοποιήσεις. Οι κρυμμένες ρυθμίσεις επιστρέφουν όταν την ενεργοποιήσεις ξανά.

Διακόπτης	Λειτουργία
row_title_stats	Στατιστικά τίτλων στις σειρές της Εξερεύνησης, στο Appearance
trakt_lists	Κλειδί Trakt, λίστες Trakt και κριτικές Trakt. Οι λίστες TMDB μένουν ενεργές
alert_channels_more	Ειδοποιήσεις μέσω Telegram, ntfy, Gotify, Pushover και webhook. Το Discord και το email μένουν ενεργά
subtitle_sites	Ιστότοποι υποτίτλων και αναζήτηση υποτίτλων. Η γλώσσα των υποτίτλων σου μένει ενεργή
emby_signin	Σύνδεση με Emby. Η ανανέωση της βιβλιοθήκης του Emby δουλεύει κανονικά
go_back	Το πλαίσιο Go back στη σελίδα Status. Τα βήματα στο Επιστροφή δουλεύουν και χωρίς αυτό

Δεν άλλαξε τίποτα μετά την προσθήκη ενός διακόπτη; Έλεγξε την ορθογραφία (πεζά, κάτω παύλες) και κάνε επανεκκίνηση στο container, όχι μόνο στη σελίδα.

Για έμπειρους

Τι στέλνει ο έλεγχος

Ένα αίτημα στο api.github.com για την πιο πρόσφατη έκδοση, με μόνο το User-Agent: HolyArrs/<version>. Χωρίς λογαριασμό, κλειδί ή λίστα πολυμέσων. Όταν ο έλεγχος είναι κλειστός, δεν γίνεται κανένα αίτημα.

Η τελευταία απάντηση αποθηκεύεται, οπότε μια επανεκκίνηση δεν κάνει έλεγχο πριν την ώρα του. Ένας έλεγχος περιμένει το πολύ 15 s, διαβάζει το πολύ 512 KB και ακολουθεί το πολύ 3 ανακατευθύνσεις, χωρίς ποτέ να αλλάζει ανάμεσα σε http και https. Ο σύνδεσμος με τις σημειώσεις έκδοσης εμφανίζεται μόνο όταν δείχνει στις σελίδες εκδόσεων του HolyArrs στο GitHub· αλλιώς η έκδοση φαίνεται ως απλό κείμενο.

Το Release feed δέχεται απάντηση εκδόσεων τύπου GitHub, λίστα εκδόσεων, οποιοδήποτε JSON με version, ή απλό κείμενο που περιέχει την έκδοση. Οι διευθύνσεις μεταδεδομένων cloud απορρίπτονται πάντα. Μια δοκιμαστική έκδοση θεωρείται παλιότερη από την απλή έκδοση.

Το αντίγραφο ασφαλείας πριν από μια ενημέρωση

Πριν αλλάξει τα αποθηκευμένα δεδομένα, το HolyArrs:

1. Ελέγχει ότι υπάρχει χώρος για ένα αντίγραφο και την ενημέρωση. Αν όχι, δεν αλλάζει τίποτα. Παράκαμψη με HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Αντιγράφει κάθε βάση δεδομένων στο backups, ελέγχει το αντίγραφο και γράφει δίπλα του ένα αρχείο sha256. Μετά από 3 αποτυχημένα αντίγραφα, δεν αλλάζει τίποτα.
3. Τρέχει κάθε βήμα ενημέρωσης ξεχωριστά και το ελέγχει. Ένα βήμα που απέτυχε αναιρείται· τα βήματα που ολοκληρώθηκαν μένουν. Ξεκίνα την ίδια έκδοση ξανά για να συνεχίσεις από το βήμα που απέτυχε με το ίδιο αντίγραφο.

Μετά την πρώτη καλή εκκίνηση το αντίγραφο γίνεται holyarrs-backup-pre-update-<time>.zip, με περιγραφή όπως “before updating from 1.1.0 to 1.2.0”. Εμφανίζεται στο Settings > Backups και στο holyarrs restore --list. Κρατιούνται τα 3 πιο πρόσφατα· ο χρονοπρογραμματισμός των αντιγράφων ασφαλείας δεν τα αφαιρεί ποτέ. Μια καθαρή εγκατάσταση ή μια ενημέρωση που δεν αγγίζει τα δεδομένα δεν φτιάχνει κανένα.

Επαλήθευσε την image

Από την 1.0.3 και μετά, κάθε image στο Docker Hub υπογράφεται από την εκτέλεση έκδοσης στο GitHub. Δεν υπάρχει κλειδί να κατεβάσεις. Έλεγξε μια image με το cosign. Βάλε την έκδοση που τρέχεις, όπως 1.0.3, εκεί που γράφει <version>:

cosign verify holyarrs/holyarrs:<version> \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp '^https://github.com/HolyArrs/HolyArrs/\.github/workflows/sign\.yml@refs/(tags/[0-9.]+|heads/main)$'

Θα πρέπει να δεις The cosign claims were validated. Οτιδήποτε άλλο σημαίνει ότι η image δεν προήλθε από την εκτέλεση έκδοσης του HolyArrs: μην την τρέξεις.

Η image φέρει επίσης ένα αρχείο με τον τρόπο που χτίστηκε και μια λίστα με ό,τι περιέχει (SBOM). Έλεγξέ τα με το GitHub CLI:

gh attestation verify oci://docker.io/holyarrs/holyarrs:<version> --repo HolyArrs/HolyArrs

Τα ίδια αρχεία υπάρχουν σε κάθε έκδοση στο GitHub: .sigstore.json (υπογραφή), .intoto.jsonl (αρχείο build) και .sbom.spdx.json (περιεχόμενα).

Σχετικά

• Αντίγραφα ασφαλείας
• Έλεγχοι υγείας
• Ενότητες και ασφαλής λειτουργία