Ręczna edycja pliku Compose ominęła zmienne zarządzane przez ZimaOS
Nowy użytkownik ZimaOS ręcznie edytował plik Compose aplikacji Jellyfin, aby zmienić ścieżki przechowywania danych. Po ponownym uruchomieniu Compose ostrzegł, że zmienne PGID, PUID, TZ i AppID nie zostały ustawione, a kilka mapowań urządzeń sprzętowych nie działało zgodnie z oczekiwaniami.
W odpowiedzi społeczność wyjaśniła, że ZimaOS zwykle wstrzykuje te wartości za pośrednictwem warstwy zarządzania aplikacjami. Edycja wygenerowanego pliku YAML poza tym mechanizmem może pozostawić symbole zastępcze bez zmiennych środowiskowych, które ZimaOS miał dostarczyć.
Zmieniaj miejsce przechowywania danych w ustawieniach aplikacji i woluminach
Zalecanym rozwiązaniem było otwarcie ustawień aplikacji Jellyfin i zmodyfikowanie tam mapowań woluminów zamiast przepisywania pliku Compose. Dzięki temu ZimaOS może zachować metadane aplikacji, zmienne środowiskowe i wpisy urządzeń, a jednocześnie zastosować wybrane ścieżki magazynu na hoście.
Autor później potwierdził, że ta metoda zadziałała. Po wybraniu prawidłowych ścieżek na dodatkowym dysku w ustawieniach aplikacji Jellyfin działał poprawnie bez ręcznej konfiguracji Compose.
Ponowna instalacja przywraca konfigurację dostarczoną przez sklep
Jeśli wygenerowana konfiguracja została już znacznie zmieniona, w odpowiedzi zaproponowano usunięcie Jellyfin z pulpitu i ponowną instalację z App Store w celu przywrócenia oryginalnych ustawień domyślnych. Przed usunięciem należy zachować istniejące dane aplikacji, korzystając z prawidłowych mapowań woluminów hosta; ponowna instalacja kontenera nie zastępuje wykonania kopii zapasowej jego konfiguracji.
Ręczna naprawa jest nadal możliwa, ale tylko pod warunkiem prawidłowego zdefiniowania każdej brakującej zmiennej i wymaganej ścieżki urządzenia. W wątku preferowano interfejs ustawień ZimaOS, ponieważ zmniejszał ryzyko pominięcia wartości zarządzanych przez system.
Mapowanie dysku w Proxmox było osobnym problemem
Autor uruchamiał ZimaOS jako maszynę wirtualną pod kontrolą Proxmox na Debianie 13. Dysk przekazany za pomocą polecenia qm set oraz nieaktualny wpis montowania w /etc/fstab powodowały problemy z trybem konserwacji po ponownym uruchomieniu. ZimaOS nadawał też urządzeniu inną nazwę, niż oczekiwał użytkownik.
Ten problem związany z wirtualizacją był niezależny od brakujących zmiennych Compose. Aby uzyskać działające rozwiązanie, potrzebne były zarówno stabilne mapowanie dysku maszyny wirtualnej, jak i prawidłowe ścieżki woluminów Jellyfin w interfejsie aplikacji ZimaOS.
Późniejsze pytanie o NTP nie dotyczyło naprawy Jellyfin
Po uruchomieniu Jellyfin wątek przeszedł do synchronizacji czasu. Działanie NTP na hoście Proxmox i w systemie gościa nie powodowało ostrzeżeń Compose, dlatego należy je diagnozować niezależnie.
FAQ
Dlaczego wartości PUID, PGID, TZ i AppID stały się puste?
Ostrzeżenia pojawiły się po tym, jak ręczne zmiany ominęły wartości zwykle zarządzane przez warstwę aplikacji ZimaOS.
Gdzie należy zmienić ścieżki przechowywania danych Jellyfin?
Potwierdzonym rozwiązaniem było użycie ustawień aplikacji Jellyfin w ZimaOS oraz dostępnych tam elementów sterujących woluminami.
Czy brakujące urządzenia sprzętowe wymagały nowych sterowników?
Wątek nie potwierdził awarii sterowników. Przywrócenie zarządzanej konfiguracji aplikacji i ścieżek woluminów rozwiązało problem z konfiguracją Jellyfin autora.
