Ten fragment opisuje kilka pozornie podobnych awarii Immich, ale nie przedstawia jednego uniwersalnego rozwiązania. W przypadku autora oryginalnego posta wyszarzona aplikacja Immich natychmiast zaczęła działać po wykonaniu polecenia sudo systemctl restart docker. Inny użytkownik wypróbował to samo polecenie, ale nadal nie mógł uruchomić Immich. Późniejszy błąd pokazał, że port hosta 2283 był już zajęty, co jest innym problemem niż niedziałający demon Dockera.
To kluczowa lekcja: po aktualizacji systemu najpierw ustal, czy Docker jako całość działa nieprawidłowo, czy problem dotyczy tylko jednego projektu Compose, czy też przestarzały lub zduplikowany kontener zajmuje już port wymagany przez Immich.
Najpierw sprawdź stan usługi Docker
Pierwsza rekomendacja użytkownika 777-Spidera dotyczyła sprawdzenia, czy Docker działa prawidłowo. Autor oryginalnego posta zrestartował następnie Dockera i poinformował, że wszystko znów działało.
Restart Dockera wpływa na wszystkie kontenery na hoście, dlatego wykonuj go świadomie i spodziewaj się ponownego uruchomienia innych aplikacji.
Restart Dockera nie był uniwersalnym rozwiązaniem problemu z Immich
Chris poinformował, że ten sam restart Dockera pomógł w przypadku innych aplikacji, ale nie przywrócił działania Immich. Jest to bezpośredni dowód na to, że systemctl restart docker nie powinno być traktowane jako gwarantowane rozwiązanie.
Jeden z błędów źródłowych wyraźnie wskazywał, że port 2283 był już zajęty
W przypadku obecnej wersji najpierw ustal, który kontener lub proces zajmuje port 2283, zanim cokolwiek usuniesz lub utworzysz ponownie. Stare, zduplikowane kontenery Immich albo częściowo odtworzony projekt Compose mogą pozostawić port zajęty.
Błąd uruchamiania aplikacji Compose dotyczy stosu aplikacji
Jeśli Docker normalnie uruchamia Paperless lub inne aplikacje, ale Immich kończy się błędem Compose, sprawdź stan usług i logi Immich oraz bieżącą definicję Compose, zamiast reinstalować cały system operacyjny.
Reinstalacja pomogła jednemu użytkownikowi, ale kosztowała czas i ponowne kopiowanie danych
Chris ostatecznie przeinstalował Immich i ponownie skopiował zdjęcia. Wyraźnie ostrzegł też o konieczności wykonywania kopii zapasowych. Była to decyzja jednego użytkownika stosowana w ostateczności, a nie potwierdzone rozwiązanie dla wszystkich.
Przed reinstalacją zachowaj AppData i bazę danych Immich
Stan Immich to nie tylko folder ze zdjęciami. Przed usunięciem kontenerów lub woluminów zachowaj bazę danych, konfigurację aplikacji oraz ścieżki bibliotek. Obecny ZimaOS przechowuje ważne dane aplikacji poza kontenerami przeznaczonymi do usunięcia.
Skorzystaj z obecnego modelu trwałych danych aplikacji w ZimaOS.
Nie traktuj tego jako bieżącej regresji Immich 1.7.1
Źródło dotyczy konkretnie ZimaOS 1.5.4 i starszej generacji Immich. Obecne wersje ZimaOS i Immich v3 są znacznie nowsze, dlatego przed zastosowaniem rozwiązania z 2026 roku odtwórz dokładny bieżący błąd.
Powrót do starszej wersji Immich może być niebezpieczny po migracji bazy danych
Jeden z użytkowników źródłowych poinformował, że wrócił do poprzedniej wersji Immich. Obecne aktualizacje do głównych wersji mogą migrować stan bazy danych i aplikacji, dlatego obsługa obniżania wersji musi wynikać z instrukcji dotyczących odpowiedniego wydania Immich, a nie tylko ze zmiany tagu obrazu na starszy.
W przypadku konfliktu portów trzeba ustalić, co już nasłuchuje na danym porcie
Błąd źródłowy wyraźnie informuje, że Docker nie mógł powiązać portu hosta 2283, ponieważ był już zajęty. Może się tak zdarzyć, gdy nadal działa stary kontener Immich, drugi stos korzysta z tego samego portu albo przypisano do niego inną usługę.
Zanim cokolwiek usuniesz, ustal, który kontener lub proces korzysta obecnie z tego portu, i zdecyduj, który stos powinien go posiadać.
Wyszarzona ikona aplikacji może wskazywać na stan Dockera, a nie utratę danych Immich
W przypadku autora oryginalnego posta restart Dockera przywrócił działanie wszystkich aplikacji. Oznacza to, że wyszarzony stan Immich wynikał z działania środowiska kontenerowego, a nie świadczył o usunięciu bazy danych zdjęć ani biblioteki.
Inny uczestnik nie odzyskał działania Immich po tym samym restarcie, co pokazuje, dlaczego sam objaw w interfejsie nie wystarcza do ustalenia przyczyny problemu.
Przed reinstalacją odczytaj błąd Compose
Komunikat „Nie udało się uruchomić aplikacji Compose” jest jedynie błędem ogólnym. Przydatnych informacji należy szukać w komunikacie dotyczących konkretnej usługi lub kontenera: konflikt portów, brak woluminu, niezdrowa baza danych, problem z pobraniem obrazu, nieprawidłowy YAML albo problem z uprawnieniami.
Przed ponownym utworzeniem stosu zachowaj logi z błędem; reinstalacja może usunąć dowody potrzebne do diagnozy.
Obecny Immich v3 sprawia, że pochopny powrót do starszej wersji jest jeszcze bardziej ryzykowny
Od czasu opisanych wydarzeń Immich przeszedł kolejne zmiany schematu i sposobu wdrażania. Współczesna baza danych v3 może nie działać bezpiecznie z dowolnym starszym obrazem tylko dlatego, że użytkownik w 2026 roku raz wrócił do wydania v1.x.
Postępuj zgodnie z aktualnymi instrukcjami Immich dotyczącymi migracji i powrotu do starszej wersji oraz przed zmianami głównej wersji miej zweryfikowane kopie zapasowe bazy danych i biblioteki.
Jeśli reinstalacja jest konieczna, najpierw zachowaj trwałe ścieżki danych
Zapisz lokalizację biblioteki zdjęć, danych PostgreSQL, konfiguracji, ścieżek uczenia maszynowego i pamięci podręcznej oraz bieżących mapowań woluminów. Usunięcie kontenerów przeznaczonych do odtworzenia to coś zupełnie innego niż usunięcie trwałych folderów na hoście.
Udana czysta reinstalacja powinna ponownie podłączyć właściwe trwałe dane albo odtworzyć je z obsługiwanej kopii zapasowej — nie powinna wymagać ponownego kopiowania jedynej biblioteki zdjęć od zera.
Często zadawane pytania dotyczące awarii Immich 1.5.4
Czy restart Dockera naprawił Immich u autora oryginalnego posta?
Tak.
Czy rozwiązało to problem każdego użytkownika w tym wątku?
Nie. Immich innego użytkownika nadal nie działał, a później wykryto konflikt dotyczący portu 2283.
Czy obecni użytkownicy powinni od razu przeinstalować Immich?
Nie. Najpierw sprawdź stan usługi Docker, stan Compose, właściciela portu oraz trwałe dane.
