Дашборд Home Assistant можно собрать в веб-интерфейсе или описать в YAML-файле. В нем размещают вкладки, секции и карточки устройств.
Что понадобится
Для работы с YAML подготовьте доступ к файлам конфигурации и редактор.
Основной файл конфигурации - configuration.yaml. Особенности установки Container разобраны в гайде Home Assistant в Docker. Как устроен каталог конфигурации, описано в документации.
Дашборд через интерфейс
Начните с Settings > Dashboards, затем добавьте вкладку и разместите карточки по секциям.
1. Новый дашборд
Откройте Settings > Dashboards и нажмите Add dashboard. Выберите New dashboard from scratch, задайте имя и значок, затем нажмите Create.
Общие правила работы с дашбордами описаны в документации дашбордов.
Кнопка Take control включает ручное редактирование дашборда, который Home Assistant сгенерировал автоматически. После ее нажатия автоматические обновления этого дашборда навсегда прекращаются.
2. Вкладка и разметка
Нажмите кнопку с карандашом, затем + в верхнем меню и задайте Title, значок и URL. Так вы добавите вкладку (view) внутри дашборда. Здесь же выберите тип разметки - Sections, Masonry, Panel или Sidebar. По умолчанию применяется Sections. Все типы вкладок перечислены в описании views.
3. Секции и карточки
Выберите Sections в поле View type, при необходимости задайте Max number of sections wide и включите Dense section placement, затем нажмите Save. Кнопка Create section добавляет секцию, карточка заголовка появляется в ней автоматически. Внутри секции карточка создается кнопкой Add card. В режиме редактирования секции перемещаются своей кнопкой переноса, карточки - перетаскиванием с зажатой кнопкой мыши. Работа секций подробнее разобрана в документации секций.
4. Выбор карточки
Откройте вкладку в режиме редактирования и нажмите Add card. Дальше выбираются либо конкретные сущности, либо тип карточки; сущности без помещения собраны в разделе Unassigned. Настройте поддерживаемые действия и возможности карточки и нажмите Done. Типы карточек перечислены в каталоге карточек.
5. Размер и видимость
В разметке Sections на вкладке Layout отключите Use recommended size и укажите число столбцов и строк. Опция Full width растягивает карточку на всю ширину секции. Внутри stack и grid (контейнеров карточек в стопке и сетке) вкладки Layout и Visibility недоступны. У карточки picture elements с элементами поверх изображения не работает Layout.
Дашборд в YAML
Зарегистрируйте отдельный файл дашборда в configuration.yaml. Локальные файлы и ресурсы подключайте при необходимости.
1. Регистрация дашборда
В configuration.yaml под ключом lovelace: добавьте блок dashboards: с отдельной записью для дашборда. В ключе записи должен быть дефис. В записи задайте mode: yaml, filename и title.
Файл из filename создается в каталоге конфигурации, внутри него описываются views: и cards:.
2. Локальные файлы
Создайте каталог www внутри /config и положите туда статические файлы - картинки, скрипты, стили. Они открываются по адресу, который начинается с /local/. Если www создан впервые, Home Assistant потребуется перезапустить. Правила доступа к таким файлам описаны в документации интеграции HTTP.
3. Ресурсы
Ресурсы - подключаемые JavaScript-файлы и стили. По умолчанию ими управляют через интерфейс в режиме storage. Чтобы вести их в YAML, добавьте под lovelace ключ resource_mode: yaml и перечислите ресурсы в resources: с полями url и type. Для JavaScript используйте module, для стилей - css.
После правок ресурсов выполняйте Reload resources.
Другие способы
Карточку можно добавить со страницы устройства, не открывая редактор дашборда. Перейдите в Settings > Devices & services, у нужной интеграции откройте список Devices, выберите устройство и нажмите Add to Dashboard. Укажите, куда добавить карточку, нажмите Next и либо примите предложенный вариант, либо выберите Pick different card.
Важные ограничения
После правок YAML стоит проверять корректность конфигурации и перезагружать или перезапускать Home Assistant; новая YAML-интеграция может требовать полного перезапуска.
Фон секции, заданный опцией Background, применяется к самой секции, а карточки в ней сохраняют собственный фон.
Частые проблемы
В таблице приведен опыт пользователей форума. Числа показывают, в скольких ветках обсуждалась каждая проблема.
| Проблема | Веток | Что помогало |
|---|---|---|
| Кастомные (пользовательские) карточки дашборда пропадают или ломаются после обновлений | 2 | Заново скачать кастомные карточки или репозиторий через HACS |
| Правки скачанного ресурса не появляются на дашборде | 1 | Удалить или переименовать файл .gz и обновить ресурс на клиенте; на Android - принудительно закрыть приложение и очистить его кеш |
| Установленная карточка погодного графика не появляется в визуальном редакторе | 1 | В списке ресурсов изменить URL, добавив в него dist |
| Рамки карточек остаются, хотя их хотят убрать | 2 | Создать и применить тему, в которой толщина рамок и радиус скругления карточек равны нулю |
| Нажатие на элемент SVG-плана этажа не открывает другую вкладку | 1 | Указать navigate как действие по нажатию элемента плана этажа |
При сбое карточек после обновлений пользователь приводил сообщение:
since the new Version 2.0 of HACS every time that I updating the HA core version
I need to redownload all custom dashboard integrations otherwise I'm getting "custom elements doesn’t exist " for all the different cards that I have .В обсуждении правок скачанного ресурса приводили сообщение:
Removing the /hacsfiles/ json resource from the dashboard resource menu and adding the identical www/community/ json resource breaks the lovelace card with an "Custom element doesn't exist" error.Кастомные карточки устанавливают через HACS или Marketplace. В Home Assistant 2026.11 (вышла 4 ноября 2026) HACS встроен как Marketplace и доступен в Settings > Marketplace, а отдельно установить HACS на 2026.11 и новее нельзя. Marketplace отдает ресурсы из /local/community/, прежние пути /hacsfiles/ продолжают работать. Подробнее - в гайдах про HACS и Marketplace и обновление Home Assistant.
Частые вопросы
Где найти и чем редактировать файлы конфигурации?
Путь к файлам указан в Configuration directory в System information. Для доступа откройте Settings > System > Repairs. На Home Assistant OS файлы правят через дополнения (аддоны, теперь apps) File editor, Studio Code Server или Samba. В установке Container таких apps нет, поэтому файлы конфигурации редактируют напрямую.
Почему условная карточка видна, хотя условие не выполнено?
В режиме редактирования дашборда условные карточки показываются всегда. Выйдите из этого режима и проверьте условия еще раз. Условный показ можно настроить и у обычной карточки на вкладке Visibility кнопкой Add condition. Если условий несколько, карточка отображается только при выполнении каждого из них.
Закрывает ли visible доступ к вкладке?
Нет, опция visible скрывает только ярлык вкладки в дашборде. Сама вкладка остается доступной по своему URL, даже когда ее ярлык скрыт. При настройке адреса вкладки используйте path. В этом пути нельзя использовать специальные символы, а начинаться он должен не с цифры.
Как сделать переход на другую вкладку по нажатию карточки?
Для перехода используйте действие navigate с параметром navigation_path в настройке tap_action. На поддерживаемых карточках можно также настроить удержание через hold_action и двойное нажатие через double_tap_action. Для запуска действия вместо перехода служит perform-action с параметрами perform_action, data и target. Возможные варианты перечислены в справочнике действий.
