Lovelace Home Assistant – gdzie znajduje się plik ui-lovelace.yaml i jak go edytować?

Home Assistant to zaawansowana platforma automatyki domowej, która pozwala tworzyć interfejs użytkownika za pomocą Lovelace. Jednym z najczęstszych pytań jest: gdzie znajduje się plik ui-lovelace.yaml i jak go edytować? Poniżej znajdziesz praktyczne, czytelne wyjaśnienia.

Czym jest Lovelace i plik ui-lovelace.yaml?

Lovelace to wizualny edytor interfejsu użytkownika Home Assistant, umożliwiający tworzenie pulpitów – personalizowanych paneli sterowania domem inteligentnym.

Plik ui-lovelace.yaml to tekstowy plik konfiguracji YAML, który zawiera definicję Twoich pulpitów, kart i zasobów. Lovelace działa w dwóch trybach: domyślnym Storage mode (konfiguracja zapisana wewnętrznie w katalogu .storage) oraz YAML mode (konfiguracja w pliku ui-lovelace.yaml).

Gdzie znajduje się plik ui-lovelace.yaml?

Poniżej znajdziesz typowe lokalizacje w zależności od rodzaju instalacji:

Typ instalacji	Typowa ścieżka	Uwagi
Home Assistant OS (HAOS)	/config/ui-lovelace.yaml	plik w katalogu głównym konfiguracji
Home Assistant Core (Linux)	/home/homeassistant/.homeassistant/ui-lovelace.yaml	lub inny katalog wskazany jako konfiguracja
Home Assistant Container (Docker)	/config/ui-lovelace.yaml	ścieżka mapowana wolumenem do kontenera

Home Assistant OS (HAOS)

W przypadku Home Assistant OS plik znajduje się w katalogu /config. Jeśli korzystasz z edytora graficznego (np. Studio Code Server), struktura folderów może wyglądać następująco:

config/
├── configuration.yaml
├── ui-lovelace.yaml
├── automations.yaml
└── .storage/

Home Assistant Core (instalacja na Linuksie)

Dla czystej instalacji Core plik zazwyczaj znajdziesz tutaj:

/home/homeassistant/.homeassistant/ui-lovelace.yaml

W praktyce będzie to folder, który wskazałeś jako katalog konfiguracyjny.

Home Assistant Container (Docker)

W środowisku Docker lokalizacja zależy od mapowania wolumenu. Najczęściej jest to:

/config/ui-lovelace.yaml

Ważne – plik istnieje tylko w YAML mode

Plik ui-lovelace.yaml nie jest tworzony automatycznie. Pojawi się dopiero po włączeniu YAML mode dla Lovelace.

Domyślnie Home Assistant używa Storage mode, w którym konfiguracja interfejsu zapisana jest w pliku .storage/lovelace i nie edytuje się jej bezpośrednio w formie tekstowej – zmiany wprowadzasz z poziomu interfejsu przeglądarkowego.

Jak włączyć YAML mode?

Krok 1 – edytuj configuration.yaml

Aby włączyć YAML mode, dodaj do pliku configuration.yaml następującą sekcję:

lovelace:
mode: yaml

Krok 2 – utwórz plik ui-lovelace.yaml

W tym samym katalogu co configuration.yaml utwórz nowy plik ui-lovelace.yaml z podstawową konfiguracją, np.:

views:
- title: Główny pulpit
cards:
- type: entities
entities:
- light.living_room

Krok 3 – zrestartuj Home Assistant

Po zapisaniu zmian zrestartuj Home Assistant. Dla bezpieczeństwa wykonaj poniższe kroki:

1. Przejdź do Ustawienia → System → Uruchom ponownie Home Assistant
2. Przed restartem kliknij Sprawdź konfigurację, aby upewnić się, że nie ma błędów

Po restarcie Home Assistant będzie korzystać z pliku ui-lovelace.yaml.

Jak migrować z Storage mode na YAML mode?

Jeśli chcesz przejść z domyślnego Storage mode na YAML mode i zachować obecną konfigurację, wykonaj te kroki:

Krok 1 – wyeksportuj aktualną konfigurację

1. Otwórz Home Assistant
2. Przejdź do Ustawienia → Pulpity
3. Kliknij Edytuj pulpit (ikona ołówka)
4. Otwórz menu (trzy kreski) i wybierz Edytuj konfigurację w edytorze surowym
5. Zaznacz wszystko (Ctrl+A) i skopiuj (Ctrl+C)

Krok 2 – utwórz plik YAML

1. Otwórz preferowany edytor tekstu (VS Code, Sublime Text itp.)
2. Wklej skopiowaną zawartość
3. Zapisz plik jako ui-lovelace.yaml w katalogu konfiguracyjnym Home Assistant

Krok 3 – skonfiguruj configuration.yaml

Dodaj poniższą sekcję do configuration.yaml i zapisz plik:

lovelace:
mode: yaml

Krok 4 – zrestartuj

Wykonaj Sprawdź konfigurację, a następnie uruchom ponownie Home Assistant.

Krok 5 – obsługa zasobów niestandardowych (opcjonalnie)

Jeśli korzystasz z niestandardowych kart lub zasobów (custom cards), dodaj sekcję resources w ui-lovelace.yaml i wskaż ścieżki do skryptów:

resources:
- url: /local/mini-graph-card-bundle.js?v=0.12.0
type: module
- url: /hacsfiles/button-card/button-card.js
type: module

views:
- title: Główny pulpit
cards: []

Jak edytować plik ui-lovelace.yaml?

Opcja 1 – edytor online w Home Assistant

Po włączeniu YAML mode możesz edytować konfigurację bezpośrednio z interfejsu Home Assistant:

1. Przejdź do Ustawienia → Pulpity
2. Kliknij Edytuj pulpit
3. Otwórz menu i wybierz Edytuj konfigurację w edytorze surowym
4. Wprowadź i zapisz zmiany

Opcja 2 – edytor Studio Code Server

Zainstaluj dodatek Studio Code Server, aby wygodnie pracować na plikach przez przeglądarkę:

1. Przejdź do Ustawienia → Dodatki → Sklep z dodatkami i zainstaluj Studio Code Server
2. Uruchom dodatek i otwórz edytor
3. Przejdź do katalogu /config
4. Edytuj ui-lovelace.yaml i zapisz

Opcja 3 – edytor SSH/SCP

Możesz edytować plik przez SSH. Wykonaj następujące polecenie w terminalu:

ssh root@twój_home_assistant nano /config/ui-lovelace.yaml

Opcja 4 – edytor lokalny

Jeśli masz bezpośredni dostęp do ścieżki na dysku (np. instalacja Core), edytuj plik dowolnym edytorem tekstu na swoim komputerze.

Struktura pliku ui-lovelace.yaml – praktyczne przykłady

Podstawowy pulpit

Prosty przykład dwóch widoków z kartami typu entities:

views:
- title: Salon
cards:
- type: entities
title: Oświetlenie
entities:
- light.salon
- title: Sypialnia
cards:
- type: entities
entities:
- light.sypialnia
- climate.klimatyzacja

Pulpit z kartami niestandardowymi

Aby użyć niestandardowej karty (np. mini-graph-card), dodaj zasób i skonfiguruj kartę w widoku:

resources:
- url: /local/mini-graph-card-bundle.js
type: module

views:
- title: Energia
cards:
- type: custom:mini-graph-card
entities:
- sensor.electricity_usage
line_color: green

Rozwiązywanie problemów

Problem – „ui-lovelace.yaml nie istnieje”

Rozwiązanie: plik jest dostępny tylko w YAML mode. Upewnij się, że w configuration.yaml masz wpis:

lovelace:
mode: yaml

Problem – „Home Assistant nie startuje po edycji ui-lovelace.yaml”

Rozwiązanie: wykonaj poniższe czynności i spróbuj ponownie:

• sprawdź składnię YAML (wcięcia, dwukropki),
• wykonaj polecenie Sprawdź konfigurację przed restartem,
• przywróć poprzednią wersję pliku.

Problem – „Nie mogę znaleźć configuration.yaml”

Rozwiązanie: skorzystaj z dodatku Studio Code Server, aby łatwo nawigować po katalogach.

Rozwiązanie: w typowych instalacjach plik znajdziesz w katalogu /config.

Powrót do Storage mode

Jeśli chcesz wrócić do domyślnego Storage mode, zastosuj poniższe kroki:

1. Usuń sekcję lovelace z pliku configuration.yaml
2. Skopiuj zawartość ui-lovelace.yaml do schowka z poziomu edytora surowego
3. Wklej konfigurację w interfejsie Lovelace (tryb graficzny)
4. Wykonaj Sprawdź konfigurację i uruchom ponownie Home Assistant