Jeśli wersja Immich wyświetlana w ZimaOS jest starsza niż wydanie Immich dostępne u producenta, a App Store nie oferuje przycisku aktualizacji, kontenery można zaktualizować ręcznie — właściwa metoda zależy jednak od zainstalowanego pakietu Immich dla ZimaOS. Wątek IceWhale Community z grudnia 2025 roku potwierdził prostą zmianę tagu obrazu dla pakietu Immich BigBear, natomiast późniejsze odpowiedzi pokazały, że ten sam sposób nie aktualizował niezawodnie każdego innego pakietu Immich.
Metoda społecznościowa polegała na otwarciu ustawień aplikacji i zmianie wyłącznie immich-server i immich-machine-learning tagi obrazów na wydanie docelowe, pozostawiając karty bazy danych i Redis bez zmian. Autor oryginalnego wpisu potwierdził, że aktualizacja przebiegła bez problemów, a inny użytkownik BigBear później pomyślnie przeszedł z wersji v2.3.1 do v2.4.1. Jednak aktualna dokumentacja Immich wymaga od administratorów zapoznania się z informacjami o wydaniu, wykonania kopii zapasowej bazy danych oraz uwzględnienia zmian w Compose/bazie danych przed aktualizacją. Oznacza to, że ręcznej zmiany tagów nie należy traktować jako uniwersalnego przycisku „zawsze bezpiecznej” aktualizacji.
Najpierw ustal, który pakiet Immich został zainstalowany
Wątek obejmuje co najmniej dwie ścieżki wdrożenia:
- Immich BigBear: kilku użytkowników zgłosiło, że edycja tagów obrazów w ZimaOS skutecznie uruchomiła aktualizację.
- Pakiet oryginalny/niepochodzący od BigBear: później inny użytkownik zgłosił, że utknął na wersji v2.1.0, nawet po próbie ręcznej zmiany wersji serwera i uczenia maszynowego.
Otwórz ustawienia aplikacji Immich w ZimaOS i przed wprowadzeniem zmian zapisz bieżące nazwy obrazów, tagi, mapowania woluminów, obraz bazy danych oraz zmienne środowiskowe. Nie zakładaj, że instrukcje napisane dla definicji BigBear pasują do innego szablonu App Store.
Działająca w społeczności aktualizacja tagu BigBear
Skuteczna procedura opisana przez społeczność była następująca:
- Na pulpicie ZimaOS otwórz menu z trzema kropkami przy aplikacji Immich.
- Wybierz Settings.
- Otwórz kartę immich-machine-learning.
- Zmień wartość Tag obrazu na wybrane wydanie Immich.
- Otwórz kartę immich-server.
- Ustaw tam ten sam tag wydania.
- Pozostaw karty bazy danych i Redis bez zmian, chyba że informacje o wydaniu wyraźnie wymagają zmiany bazy danych/kontenera.
- Zapisz konfigurację i pozwól ZimaOS odtworzyć/pobrać zmienione kontenery.
W momencie opublikowania oryginalnej odpowiedzi przykładowy tag to:
v2.3.1Ta wersja jest historyczna. Później inny użytkownik zaktualizował do v2.4.1, a w odpowiedzi z kwietnia 2026 roku wspomniano v2.7.4. Nie kopiuj dziś żadnego z tych starych numerów wersji. Wersję docelową wybierz dopiero po sprawdzeniu aktualnych informacji o wydaniach Immich i swojej ścieżki aktualizacji.
Co potwierdził autor oryginalnego wpisu
Po otrzymaniu instrukcji dotyczących tagu BigBear firma MikeFrizz odpowiedziała, że wskazówka była bardzo pomocna, a aktualizacja przebiegła bez problemów. To najsilniejszy potwierdzony rezultat w tym wątku.
To potwierdzenie wspiera tę metodę dla pakietu i kontekstu wersji użytych przez autora oryginalnego posta. Nie dowodzi jednak, że ręczna edycja dwóch tagów wystarczy dla każdej przyszłej głównej wersji Immich ani każdego pakietu ZimaOS.
Nie zakładaj, że tag „latest” rozwiąże problem
Jeden z użytkowników zmienił tag na latest, ale ZimaOS wielokrotnie powracał do wcześniej zainstalowanej wersji. Wątek zawiera następnie przypuszczenia, takie jak próba użycia wydanie, ale nie ma potwierdzonego w źródłach uniwersalnego rozwiązania opartego na tych ogólnych nazwach tagów.
Aktualna dokumentacja Immich używa jawnej zmiennej wersji i obsługuje metatagi głównych wersji w swoim własnym procesie Docker Compose. W przypadku spakowanej aplikacji ZimaOS użyj formatu tagu obsługiwanego przez definicję pakietu i rzeczywisty obraz upstream. Unikaj tworzenia tagów na podstawie samego brzmienia etykiety.
Utwórz kopię zapasową Immich przed zmianą wersji
Aktualna dokumentacja Immich wyraźnie zaleca wykonanie kopii zapasowej bazy danych przed aktualizacjami, które mogą obejmować migracje. Twoje zdjęcia i filmy również wymagają niezależnej strategii tworzenia kopii zapasowych; kopia bazy danych nie zastępuje samej biblioteki multimediów.
Przed ręczną zmianą wersji skorzystaj z aktualnego przewodnika tworzenia kopii zapasowych i przywracania Immich.
Co najmniej zachowaj:
- kopię zapasową bazy danych Immich;
- dane biblioteki multimediów i przesyłanych plików;
- aktualną konfigurację aplikacji ZimaOS i mapowania wolumenów;
- aktualne tagi obrazów;
- oraz wszelkie zmienne środowiskowe lub niestandardowe lokalizacje przechowywania.
Przeczytaj informacje o wydaniu Immich przed każdą zmianą wersji
Aktualna dokumentacja aktualizacji Immich informuje, że przed aktualizacją administratorzy powinni sprawdzić informacje o wydaniu pod kątem zmian powodujących niezgodność. Standardowy proces upstream z użyciem Docker Compose wygląda następująco:
docker compose pull && docker compose up -dale dopiero po dostosowaniu definicji Compose i zmiennych wersji do docelowego wydania.
Zobacz aktualny przewodnik aktualizacji Immich.
Ma to znaczenie w przypadku ZimaOS, ponieważ spakowana aplikacja może być opóźniona nie tylko pod względem tagów obrazów, lecz także definicji równoważnej Compose. Nowsza immich-server obraz może wymagać zmian w bazie danych, środowisku, kontroli stanu lub wolumenach, których nie zawiera starszy pakiet.
Zachowaj zgodność wersji serwera Immich i uczenia maszynowego
Społeczność zmieniła konkretnie tagi obu immich-server i immich-machine-learning. Aktualna dokumentacja Immich również ostrzega, że niezgodność wersji między głównym serwerem a komponentami uczenia maszynowego może powodować błędy lub niestabilność.
Nie aktualizuj tylko jednego z nich dlatego, że akurat jako pierwszy wyświetlił dostępny obraz. Traktuj je jako jedną skoordynowaną wersję aplikacji, chyba że aktualna dokumentacja wydania wyraźnie stanowi inaczej.
Nie zmieniaj losowo tagu kontenera bazy danych
Porada społeczności, aby pozostawić kartę bazy danych bez zmian, była rozsądna w przypadku omawianych dokładnych aktualizacji minor w BigBear. Warstwa PostgreSQL Immich ma własne migracje i z czasem ulegała zmianom, w tym migracji ze starszych rozszerzeń wektorowych do VectorChord.
- Nie aktualizuj obrazu bazy danych tylko po to, aby wszystkie tagi wyglądały na numerycznie podobne.
- Nie zakładaj, że obraz bazy danych nigdy nie powinien się zmienić; jeśli aktualne informacje o wydaniu Immich wymagają migracji bazy danych lub Compose, postępuj zgodnie z udokumentowaną procedurą migracji.
Co zrobić, jeśli oryginalna aplikacja Immich w ZimaOS pozostaje przy starej wersji?
W odpowiedzi z marca 2026 r. stwierdzono, że użytkownik nie korzystał z wersji ze sklepu z aplikacjami BigBear i nadal pozostawał przy Immich v2.1.0, nawet po ręcznych próbach aktualizacji obrazów uczenia maszynowego i serwera. Wątek nie zawiera potwierdzonego rozwiązania dotyczącego wdrożenia oryginalnego pakietu tego użytkownika.
To ważna granica: jeśli ręczna zmiana tagów obrazów nie aktualizuje aplikacji, przerwij powtarzanie tej samej operacji. Porównaj bieżącą definicję kontenerów pakietu z aktualnymi wymaganiami Compose dla Immich i rozważ migrację do utrzymywanego pakietu ZimaOS dopiero po utworzeniu kopii zapasowej i potwierdzeniu ścieżek danych.
Nie odinstalowuj działającego pakietu Immich, dopóki nie wiesz, gdzie są przechowywane woluminy bazy danych i multimediów.
Dlaczego użytkownicy społeczności sugerowali pakiet Immich od BigBear
Pierwsza odpowiedź zalecała aplikację Immich od BigBear, ponieważ zwykle była aktualizowana bliżej wydań upstream. Późniejsze, skuteczne instrukcje edycji tagów również zostały wyraźnie przetestowane na BigBear.
Nie oznacza to, że „ponowna instalacja BigBear” jest bezpieczną migracją istniejącej biblioteki za pomocą jednego kliknięcia. Nowy pakiet może używać innych nazw woluminów, katalogów danych, obrazów baz danych lub zmiennych środowiskowych. Traktuj migrację pakietu jako osobną operację, niezależną od aktualizacji istniejącego stosu.
Zachowaj ostrożność w przypadku automatycznych narzędzi do aktualizowania kontenerów
W kwietniu 2026 r. w odpowiedzi społeczności zasugerowano Tugtainer jako łatwiejszą alternatywę dla Watchtower do sprawdzania i automatycznego aktualizowania kontenerów. Może to być wygodne w przypadku usług bezstanowych, ale Immich jest stanową aplikacją wielokontenerową z bazą danych PostgreSQL i udokumentowanymi ścieżkami aktualizacji obejmującymi zmiany powodujące niezgodność.
W przypadku Immich automatyczna zamiana obrazów bez zapoznania się z informacjami o wydaniu może być ryzykowna. Aktualna dokumentacja Immich wyraźnie zaleca administratorom uwzględnienie zmian powodujących niezgodność przed aktualizacją. Jeśli w ogóle używasz automatycznego narzędzia do aktualizowania kontenerów, w przypadku Immich wybierz powiadomienia i ręczne zatwierdzanie zamiast bezkrytycznej aktualizacji każdego nowego tagu.
Bezpieczniejszy proces aktualizacji Immich w ZimaOS
- Zapisz, czy zainstalowany pakiet pochodzi z BigBear, czy jest inną definicją Immich.
- Zapisz aktualne obrazy i tagi serwera, uczenia maszynowego, bazy danych oraz Redis.
- Utwórz kopię zapasową bazy danych Immich i ważnych multimediów.
- Przeczytaj informacje o wydaniu projektu nadrzędnego dla każdej granicy wprowadzającej niezgodne zmiany między bieżącą a docelową wersją.
- Potwierdź, czy docelowa wersja wymaga zmian w Compose, bazie danych, zmiennych środowiskowych lub pamięci masowej.
- W przypadku zgodnej aktualizacji pomocniczej BigBear zmień jednocześnie tagi serwera i uczenia maszynowego, tak jak zrobiła to społeczność.
- Pozostaw obrazy bazy danych i Redis bez zmian, chyba że udokumentowana ścieżka aktualizacji wyraźnie wymaga ich zmiany.
- Zapisz ustawienia aplikacji i obserwuj logi kontenerów podczas uruchamiania nowych obrazów.
- Sprawdź wersję w interfejsie internetowym Immich, przesyłanie plików, miniatury, uczenie maszynowe i istniejącą bibliotekę przed usunięciem starych obrazów.
- Jeśli pakiet natychmiast wraca do poprzedniej wersji lub pozostaje przy starej wersji, sprawdź definicję pakietu zamiast wielokrotnie wymuszać tagi.
Co należy sprawdzić po aktualizacji Immich
- Interfejs internetowy ładuje się i wyświetla zamierzoną wersję serwera.
- Aplikacja mobilna może się połączyć i jest zgodna z główną wersją serwera.
- Istniejące zdjęcia i filmy otwierają się prawidłowo.
- Nowe przesyłane pliki kończą się pomyślnie.
- Zadania generowania miniatur i transkodowania działają.
- Funkcje uczenia maszynowego uruchamiają się bez błędów niezgodności wersji.
- Kontener PostgreSQL pozostaje sprawny.
Aktualna dokumentacja Immich wskazuje, że obniżenie wersji nie jest obsługiwaną strategią odzyskiwania. Kopia zapasowa jest bezpieczniejsza niż założenie, że po migracji bazy danych można po prostu przywrócić poprzedni tag.
Najczęściej zadawane pytania dotyczące aktualizacji Immich w ZimaOS
Czy mogę zaktualizować Immich, zmieniając tagi obrazów ZimaOS?
Tak, w przypadku niektórych kombinacji pakietu i wersji. Autor pierwotnego wpisu oraz inny użytkownik BigBear potwierdzili, że zmiana tagów serwera i uczenia maszynowego zadziałała. Wątek zawiera również przypadek użytkownika spoza BigBear, u którego ta metoda nie rozwiązała problemu nieaktualnej instalacji.
Które tagi Immich powinienem zmienić?
W potwierdzonej metodzie społeczności BigBear immich-server i immich-machine-learning tagi zostały zmienione jednocześnie. Nie kopiuj starych przykładów v2.3.1, v2.4.1 ani v2.7.4 jako aktualnych wersji docelowych.
Czy powinienem używać latest?
Nie jako uniwersalnego rozwiązania. Użytkownik w wątku zgłosił, że latest nie zadziałało. Użyj schematu wersjonowania obsługiwanego przez rzeczywisty pakiet i aktualne zalecenia Immich.
Czy mogę po prostu uruchomić docker pull?
Samo pobranie nowego obrazu nie odtwarza uruchomionego kontenera ani nie stosuje zmian w Compose. Immich korzysta z docker compose pull && docker compose up -d po przygotowaniu konfiguracji dla docelowej wersji.
Czy Tugtainer lub Watchtower powinny automatycznie aktualizować Immich?
Automatyczne aktualizacje mogą pomijać analizę informacji o wydaniu i migracji, którą Immich wyraźnie zaleca. W przypadku aplikacji stanowej z bazą danych bezpieczniejsze są powiadomienia i kontrolowane, ręczne aktualizacje niż ślepe zastępowanie.
Czy przed aktualizacją Immich potrzebuję kopii zapasowej?
Tak. Aktualna dokumentacja Immich dotycząca aktualizacji i tworzenia kopii zapasowych zaleca zabezpieczenie bazy danych przed aktualizacjami, a także osobne zabezpieczenie niezastąpionych plików multimedialnych.
