Jak uzyskać dostęp do katalogu .storage w Home Assistant?

Pytanie

home assistant jak zobaczyć katalog .storage

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• W Home Assistant katalog .storage znajduje się w głównym katalogu konfiguracji (/config/.storage lub ~/.homeassistant/.storage) i jest domyślnie ukryty.
• Aby go wyświetlić:
  • W File Editor/VS Code – włącz opcję „Pokaż ukryte pliki” lub usuń .storage z listy wykluczeń.
  • Przez SSH/Terminal – wykonaj cd /config && ls -la i wejdź cd .storage.
  • Przez Samba Share – włącz pokazywanie ukrytych plików w eksploratorze systemu operacyjnego.

Kluczowe punkty
• Ukryty, bo zawiera krytyczne dane konfiguracyjne.
• Nie edytować na żywym systemie bez kopii zapasowej.

Bezpośrednia odpowiedź na pytanie

Szczegółowa analiza problemu

1. Lokalizacja katalogu

   • HA OS / Supervised / Container: /config/.storage
   • HA Core (virtualenv): ~/.homeassistant/.storage

2. Metody dostępu
   a) File Editor (dodatek)
   – Ustawienia → ignore pattern → usuń .storage → Zapisz → Odśwież.
   b) Visual Studio Code (dodatek)
   – Settings → files.exclude → usuń/wyłącz .storage.
   c) SSH & Web Terminal / natywny SSH

      login            # połączenie SSH
      cd /config       # katalog konfiguracji
      ls -la           # ukryte katalogi
      cd .storage      # wejście

   d) Samba Share
   – Zainstaluj dodatek, włącz, na PC wpisz \\homeassistant.local\config, w Eksploratorze Windows zaznacz „Ukryte elementy” lub w macOS użyj Cmd + Shift + ..
   e) Docker host
   – Wejdź w katalog zmapowany w docker-compose.yml, np. /srv/ha/config/.storage.

3. Co zawiera .storage

   • core.config_entries – konfiguracje integracji
   • core.entity_registry, core.device_registry – rejestry encji i urządzeń
   • lovelace.* – dashboardy UI
   • auth, auth_provider.* – dane logowania
   • Pliki specyficzne integracji (tokeny, stany)

4. Teoretyczne podstawy
   Home Assistant od 0.113+ przeniósł większość konfiguracji tworzonych przez UI do struktury JSON w .storage, co pozwala na dynamiczne modyfikacje bez ręcznej edycji configuration.yaml.

5. Praktyczne zastosowania

   • Usunięcie „martwej” encji niedostępnej z poziomu UI.
   • Diagnostyka problemów z integracjami (porównanie wpisów JSON).
   • Eksport/backup definicji Lovelace.

Aktualne informacje i trendy

• Od wersji 2023.x HA jeszcze silniej chroni .storage; edytory domyślnie filtrują ukryte pliki.
• Twórcy zalecają korzystanie z UI i REST API zamiast bezpośredniej edycji JSON.
• Community pracuje nad narzędziami walidującymi pliki .storage (skrypty Python/CLI).

Wspierające wyjaśnienia i detale

• Po ręcznej edycji JSON wymagany jest restart HA, aby pliki zostały załadowane.
• Błąd składniowy (np. brak przecinka) uniemożliwi start – log pokaże Error loading /config/.storage/....
• Dla pewności:

  jq empty core.entity_registry   # szybka walidacja JSON (narzędzie jq)

• Kopia zapasowa: cp core.entity_registry core.entity_registry.bak.

Aspekty etyczne i prawne

• Pliki zawierają dane osobowe (użytkownicy, tokeny). Udostępnianie ich publicznie może naruszyć RODO/GDPR.
• Modyfikacja integracji korzystających z chmurowych API (np. Google, Alexa) może łamać warunki licencyjne, jeśli usuniemy ograniczenia regionu lub limitów.
• Zapewnienie bezpieczeństwa: ograniczyć dostęp SSH/Samba hasłem i kluczami, stosować szyfrowanie transportu.

Praktyczne wskazówki

• Zawsze wykonuj pełny snapshot (Supervisor → Kopie zapasowe) przed zmianami.
• Edycję prowadź przy zatrzymanym HA (ha core stop lub wyłączenie kontenera).
• Waliduj JSON online (jsonlint.com) lub lokalnie (python -m json.tool).
• Po zmianach uruchom ha core start i monitoruj logi (ha core logs).

Ewentualne zastrzeżenia lub uwagi dodatkowe

• System może nadpisać ręczne zmiany przy najbliższej operacji w UI.
• Nie wszystkie problemy (np. zduplikowane encje Z-Wave) da się rozwiązać wyłącznie edycją .storage.
• Przy instalacji Container bez trybu privileged część plików może mieć inne uprawnienia (UID/GID mapowane z hosta).

Sugestie dalszych badań

• Dokumentacja oficjalna: https://www.home-assistant.io/docs/
• REST API /api/config i /api/states – alternatywny odczyt danych bez ruszania .storage.
• Narzędzie CLI ha (Supervisor → SSH) – komendy ha config info, ha backups.
• Społeczność: forum Home Assistant – dział „Configuration”.

Krótkie podsumowanie

Katalog .storage to ukryte, krytyczne repozytorium konfiguracji zarządzanej przez interfejs Home Assistant. Aby go zobaczyć, włącz wyświetlanie ukrytych plików w edytorze (File Editor/VS Code) lub użyj ls -la w SSH/Samba. Przed jakąkolwiek edycją wykonaj kopię zapasową, zatrzymaj HA i waliduj JSON, gdyż błędy mogą zablokować start systemu. Ostrożność i backupy są tu kluczowe.