Obejście opisane w źródle było praktyczne dla jednego pakietu Immich z 2025 r., ale nie powinno zostać utrwalone w aktualnym poradniku aktualizacji. Użytkownik społeczności ręcznie zmienił maniery immich-server oraz immich-machine-learning tagi obrazów do v1.134.0. Autor oryginalnego wpisu powiedział, że ostatecznie zadziałało to na jego głównym systemie ZimaOS, ale nie na testowej maszynie wirtualnej.
Immich od tego czasu przeszedł na v3, a jego utrzymywany model wdrażania wykorzystuje kompletny stos Docker Compose oraz wartość IMMICH_VERSION. Aktualizacja tylko jednego lub dwóch tagów usług może utworzyć stos z mieszanymi wersjami, gdy zmienią się założenia dotyczące bazy danych, pamięci podręcznej, uczenia maszynowego lub interfejsu API.
Źródło z 2025 r. edytowało tagi poszczególnych usług Immich
Społeczność zaleciła użytkownikowi zmianę obu tagów: serwera i uczenia maszynowego
CogZog powiedział, że oba immich-server oraz immich-machine-learning powinien używać nowego tagu. Użytkownik potwierdził, że zmienił oba, ale testowa maszyna wirtualna nadal pozostała przy starszej wersji.
Główna kompilacja ZimaOS ostatecznie osiągnęła wersję v1.134.0
Źródło nie ustanowiło zasady ręcznej aktualizacji obrazu bazy danych
beep zapytał, czy bazę danych również należy przenieść do nowszego/stabilnego tagu. Odpowiedź społeczności była zasadniczo następująca: „jeśli coś działa, nie naprawiaj tego”. Była to opinia, a nie zasada migracji Immich.
Obecnie Immich to v3 — ze ścieżką pełnej aktualizacji Compose
Immich v3.0.0 wydano w lipcu 2026 r. Dokumentacja upstream zaleca aktualizację utrzymywanego stosu przez ustawienie IMMICH_VERSION=v3 oraz uruchomienie standardowego procesu pobierania i ponownego tworzenia za pomocą Compose, a także zapoznanie się z uwagami dotyczącymi przełomowych zmian i migracji w wersji v3.
Zobacz obeczne wytyczne dotyczące wydania Immich v3.
Obecnie projekt nadrzędny zaleca pełny pakiet Docker Compose
Obecna dokumentacja instalacji Immich zaleca użytkownikom pobranie docker-compose.yml oraz .env, a następnie ustaw lokalizacje i IMMICH_VERSION. Ścieżka bazy danych PostgreSQL powinna pozostać na obsługiwanym lokalnym systemie plików, a nie na udziale sieciowym.
W przypadku wdrożeń ręcznych lub niestandardowych użyj obecnego modelu Compose Immich.
W przypadku pakietu ze Sklepu aplikacji ZimaOS preferuj obecną ścieżkę aktualizacji aplikacji
Obecny Sklep aplikacji ZimaOS 2.0 obejmuje zarządzanie aktualizacjami zainstalowanych aplikacji. Jeśli pakiet sklepu oferuje aktualizację Immich, pozwól, aby definicja pakietu zaktualizowała cały stos usług, zamiast niezależnie zmieniać tag jednej usługi.
Wykonaj kopię zapasową przed główną aktualizacją Immich
Przed zmianą głównej wersji zabezpiecz zarówno bibliotekę zdjęć i filmów, jak i stan bazy danych oraz aplikacji. Sam zdrowy katalog biblioteki nie wystarczy do odtworzenia albumów, użytkowników, metadanych i stanu aplikacji.
Unikaj tworzenia stosu Immich z mieszanymi wersjami
Immich nie jest jednym niezależnym kontenerem. Aplikacja, usługa uczenia maszynowego, baza danych i inne komponenty pomocnicze są testowane jako skoordynowana topologia wydania. Zaktualizowanie jednego obrazu, gdy inny pozostaje przypięty do konkretnej wersji, może spowodować niezgodności interfejsu API, schematu lub uruchamiania.
Źródło zadziałało dopiero wtedy, gdy efektywny stos użytkownika był wystarczająco zgodny, aby uruchomić v1.134.0; nie dowodzi to, że dowolne mieszanie tagów jest bezpieczne.
Przechowuj PostgreSQL na obsługiwanej pamięci lokalnej
Obecne wymagania Immich mówią, że katalog danych PostgreSQL powinien korzystać z lokalnego systemu plików i nie powinien znajdować się na udziale sieciowym. Stan bazy danych jest zazwyczaj niewielki w porównaniu z biblioteką zdjęć, ale ma kluczowe znaczenie dla użytkowników, albumów, metadanych i stanu aplikacji.
Dowiedz się, czy zainstalowano pakiet ZimaOS, czy niestandardowy stos Compose
Jeśli Immich pochodzi ze sklepu App Store ZimaOS, skorzystaj z bieżącej ścieżki aktualizacji sklepu i przejrzyj zmiany w jego pakiecie. Jeśli zaimportowano własny plik Compose, odpowiadasz za przypięcie wersji nadrzędnej, .env, ścieżki bazy danych i kroków migracji.
Mieszanie zmian w App Store z ręcznie utrzymywanym stosem nadrzędnym utrudnia późniejsze rozwiązywanie problemów.
Wykonaj czynności wstępne przed dużą aktualizacją
- Potwierdź, że istnieje aktualna kopia zapasowa biblioteki zdjęć.
- Wykonaj kopię zapasową bazy danych i stanu aplikacji.
- Zapisz bieżącą wersję i mapowania wolumenów.
- Przeczytaj informacje o zmianach powodujących niezgodność w projekcie nadrzędnym.
- Upewnij się, że na dysku systemowym/AppData jest wystarczająco dużo wolnego miejsca na pobieranie obrazów i migracje.
Zweryfikuj uruchomioną wersję i zadania po aktualizacji
Nie poprzestawaj na komunikacie „Zapisywanie zakończone”. Otwórz stronę About/System w Immich, potwierdź wersję uruchomionego serwera, sprawdź stan kontenerów, a następnie zweryfikuj przesyłanie plików, miniatury, zadania uczenia maszynowego i łączność z aplikacją mobilną.
Samo źródło pokazuje dlaczego: edycja tagu nie oznaczała od razu, że uruchomiona instancja faktycznie została zaktualizowana.
Wycofanie zmian nie zawsze polega tylko na ponownym ustawieniu poprzedniego tagu
Po migracji schematu bazy danych lub stanu przez wydanie główne obniżenie wersji obrazu może nie być obsługiwane. Zamiast zakładać, że poprzedni tag jest uniwersalnym przyciskiem cofania, skorzystaj ze wskazówek dotyczących migracji i wycofywania zmian udostępnionych przez projekt oraz z kopii zapasowych.
FAQ dotyczące aktualizacji Immich
Czy metoda ręcznego ustawiania tagu z 2025 roku zadziałała w głównym systemie użytkownika źródłowego?
Tak, ostatecznie. Ich testowa maszyna wirtualna nie zachowywała się tak samo.
Czy obecni użytkownicy Immich powinni aktualizować tylko tagi immich-server i machine-learning?
Nie. Obecny Immich v3 jest utrzymywany jako kompletny stos Compose wraz ze wskazówkami dotyczącymi wersji i migracji.
Czy IceWhale obiecało w źródle automatyczne aktualizacje Immich?
Nie. Zima-Giorgio powiedział tylko, że zespół omówi tę prośbę.
