Системный администратор, интегратор

Установка EAS на сервер

Развёртывание на Ubuntu, первый вход в админку и проверка работы.

  1. 1

    Подготовьте сервер

    Ubuntu 22.04+. **Минимум для пилота:** 2 ядра, 4 ГБ RAM, 80 ГБ SSD — до ~8 камер, 30 датчиков, 2 контроллера. Для крупного объекта см. отдельную инструкцию по расчёту железа (100 камер / 100 датчиков / 10 контроллеров — ориентир 12–16 ядер, 32 ГБ RAM, 2–4 ТБ под архив). Статический IP, порты 8000 (админка) и доступ панелей СКУД к серверу.

    Совет: Подробные таблицы: /docs/server-sizing/

  2. 2

    Запустите установщик

    На сервере Ubuntu выполните одну команду (см. блок ниже) — скрипт скачает актуальный bundle с хаба (manifest.json), распакует и запустит нативную установку: PostgreSQL, Python venv, eas-server, Home Assistant, мастер первой настройки. Время: от 30 минут до 2 часов.

    curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula
    Команда установки EAS в терминале

    Совет: Без Home Assistant: curl -fsSL https://asceas.ru/eas-hub/install/install-eas-from-hub.sh | sudo EAS_ACCEPT_EULA=1 bash -s -- --accept-eula --without-ha. Манифест релизов: https://asceas.ru/eas-hub/manifest.json

  3. 3

    Что уже сделано автоматически

    После мастера без ручных команд работают: служба eas-server (админка :8000), служба home-assistant (:8123), запись «Локальный Home Assistant» (127.0.0.1:8123) в базе EAS. Проверка: systemctl is-active eas-server home-assistant и curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:8123/ — обычно 302 (страница onboarding).

    Совет: Для HA из коробки рекомендуется ≥4 ГБ RAM. На слабых VM первый ответ :8123 может занять 10–20 минут после pip.

  4. 4

    Первый вход в админку EAS

    Откройте http://<IP-сервера>:8000/admin, войдите с учётными данными из eas.bootstrap.credentials и смените пароль. Мастер в неинтерактивном режиме (curl | bash) создаёт пользователя admin автоматически.

    Экран входа в админку EAS

    Совет: Для HTTPS настройте nginx или Caddy перед uvicorn — в продакшене не оставляйте только HTTP.

  5. 5

    Onboarding Home Assistant (только в браузере)

    Home Assistant нельзя настроить полностью из терминала: откройте http://<IP-сервера>:8123, создайте учётную запись администратора HA (имя, пароль, часовой пояс, геолокацию). Это отдельный пароль от EAS — не путайте с admin в eas.bootstrap.credentials.

    Совет: Если :8123 не открывается: journalctl -u home-assistant -n 50 — дождитесь окончания pip при первой установке.

  6. 6

    Токен HA и связка с EAS

    В Home Assistant: профиль (иконка слева внизу) → «Безопасность» → «Долгоживущие токены доступа» → «Создать токен». Скопируйте строку. В EAS: «Администрирование» → «Home Assistant» (или «Интеграции» → кнопка «Открыть Home Assistant») → у строки «Локальный Home Assistant» нажмите «Токен / изменить» → вставьте токен → сохраните → «Синхронизировать сущности».

    Вкладка Home Assistant в админке EAS — токен и синхронизация

    Совет: Альтернатива для HA в другой подсети: кнопка «Мастер HA» на той же странице (подсеть + токен).

  7. 7

    Проверьте состояние сервера

    Войдите под администратором. В шапке отображаются логин, роль и тема интерфейса. Откройте «Администрирование → Сервер и службы» — убедитесь, что служба eas-server активна и диск не переполнен.

    Вкладка «Сервер и службы»
  8. 8

    Активируйте лицензию

    Перейдите во вкладку «Лицензия», введите ключ триала или постоянной лицензии и нажмите «Активировать». Без лицензии часть функций будет ограничена.

    Активация лицензии EAS