Lokalizacja i użycie pliku customize.yaml w Home Assistant

Pytanie

home assistant gdzie jest customize.yaml

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• Plik customize.yaml znajduje się w głównym katalogu konfiguracyjnym Home Assistant (tam, gdzie configuration.yaml).
• Typowe ścieżki:
  • Home Assistant OS / Supervised: /config/customize.yaml (fizycznie na hoście: /mnt/data/supervisor/homeassistant/customize.yaml; przez Samba: \\config\customize.yaml)
  • Home Assistant Container (Docker): w kontenerze /config/customize.yaml; na hoście – ścieżka, którą podmontowałeś jako wolumin do /config
  • Home Assistant Core (venv): ~/.homeassistant/customize.yaml

Szczegółowa analiza problemu

• customize.yaml nie jest tworzony automatycznie. Jeśli go nie widzisz, po prostu go utwórz obok configuration.yaml.
• Aby HA wczytywał jego zawartość, w configuration.yaml (sekcja homeassistant) musi być:
  • homeassistant:
    customize: !include customize.yaml
• Alternatywnie możesz użyć innej nazwy/lokalizacji:
  • homeassistant:
    customize: !include custom/moje_dostosowania.yaml
    lub kilku plików:
  • homeassistant:
    customize: !include_dir_merge_named customize/
• Jak sprawdzić, gdzie jest katalog config:
  • W HA: Ustawienia → System → Informacje (albo Narzędzia deweloperskie → Informacje) – zobaczysz ścieżkę do configuration.yaml. W tym samym folderze umieszczasz customize.yaml.
• Minimalny przykład zawartości customize.yaml:
  • light.salon:
    friendly_name: "Żyrandol w salonie"
    icon: mdi:ceiling-light
  • sensor.temp_zew:
    unit_of_measurement: "°C"
    device_class: temperature
• Przeładowanie zmian:
  • Po dodaniu dyrektywy !include – zrestartuj HA.
  • Po późniejszych zmianach w customize.yaml użyj: Ustawienia → System → Kontrola serwera → (Przeładuj lokalizację i dostosowania) lub wykonaj restart.
• Uwaga praktyczna: część atrybutów (np. nazwa i ikona) da się dziś zmieniać z poziomu UI (ikona koła zębatego na karcie encji). customize.yaml nadal przydaje się do bardziej „niskopoziomowych” nadpisań. Niektóre integracje mogą ignorować niektóre atrybuty wymuszone przez customize.

Aktualne informacje i trendy

• W nowszych wersjach HA preferowane są zmiany przez UI, a YAML pozostaje dla bardziej zaawansowanych przypadków lub gdy UI nie oferuje danej opcji.
• Konfigurację YAML zaleca się dzielić na pliki (!include, !includedir*), co ułatwia utrzymanie i wersjonowanie.

Wspierające wyjaśnienia i detale

• Logiczna ścieżka /config widoczna w UI mapuje się w HA OS/Supervised na katalog /mnt/data/supervisor/homeassistant w systemie hosta.
• W Dockerze /config w kontenerze to hostowy katalog podany w -v /ścieżka/na/hoście:/config.

Aspekty etyczne i prawne

• Zadbaj o bezpieczeństwo dostępu do plików (Samba/SSH z hasłem i ograniczeniami).
• Rób kopie zapasowe konfiguracji przed zmianami.

Praktyczne wskazówki

• Jeśli nie masz pliku: utwórz /config/customize.yaml, dodaj wpis !include, sprawdź konfigurację, zrestartuj.
• Valdacja: Ustawienia → System → Kontrola serwera → Sprawdź konfigurację.
• Pamiętaj o poprawnych wcięciach YAML (spacje, nie tabulatory).

Ewentualne zastrzeżenia lub uwagi dodatkowe

• Nie każda encja przyjmie wymuszone device_class czy unit_of_measurement – zależy od integracji.
• Część zmian może wymagać pełnego restartu, jeśli przeładowanie z UI nie jest dostępne.

Sugestie dalszych badań

• Dokumentacja: „Customizing entities” oraz „Splitting up the configuration”.
• Praktyka: utrzymuj customize w osobnym katalogu (np. /config/customize/) i łącz przez !include_dir_merge_named.

Krótkie podsumowanie

• customize.yaml leży w tym samym katalogu co configuration.yaml (zazwyczaj /config) i działa dopiero po dodaniu homeassistant: customize: !include customize.yaml.
• Jeśli podasz swoją metodę instalacji (HA OS, Docker, Core), wskażę dokładną ścieżkę i kroki dla Twojego środowiska.