Установка

Grablo Spot работает в Windows, macOS и на множестве устройств с Linux, например Raspberry Pi, Jetson и Radxa. Все установочные файлы доступны на странице загрузки.

Поддерживаются одноплатные компьютеры Raspberry Pi 3/4/5 и Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin) и Radxa Rock (5A, 5B, 5C, Zero 3W).

Windows и macOS

Скачайте установщик (Windows: .exe, macOS: .pkg) со страницы загрузки, запустите его и следуйте инструкциям. После завершения установки Grablo запускается автоматически.

Готовый образ (Raspberry Pi)

Запишите на SD-карту образ Raspberry Pi OS с предустановленным Grablo. Grablo автоматически запускается как системная служба при загрузке, поэтому для новых пользователей это самый простой вариант. Доступны полный образ с рабочим столом и облегченный образ только с командной строкой.

Скачанный файл образа (.img.xz) можно записать и обычными программами записи образов, например balenaEtcher, но рекомендуется Raspberry Pi Imager: в нем можно настроить Wi-Fi и учетную запись пользователя прямо во время записи карты. Шаги и экраны ниже описаны для Raspberry Pi Imager 1.9. При выборе операционной системы выберите Use custom и укажите файл образа.

В разделе выбора накопителя укажите SD-карту для записи и нажмите Next. Появится окно с вопросом, применить ли настройки ОС.

В этом окне выберите Edit Settings, чтобы заранее задать имя хоста, учетную запись пользователя, Wi-Fi и региональные параметры. Если компьютер будет работать без монитора и без Ethernet, обязательно настройте Wi-Fi. Если вы не меняли настройки, вход в Raspberry Pi OS по умолчанию: grablo / grablo.

Если включить SSH на вкладке Services, к компьютеру можно будет подключаться по сети без монитора. Закончив, нажмите Save, вернитесь в окно настроек ОС и нажмите Yes. Подтвердите предупреждение о том, что существующие данные на SD-карте будут удалены, и начнется запись.

После завершения записи вставьте SD-карту в Raspberry Pi и подключите питание. Grablo автоматически запускается как системная служба при каждой загрузке, вход в систему не требуется.

Дополнение Home Assistant

В Home Assistant OS или Supervised установите Grablo как дополнение. Дополнение подключается к Home Assistant автоматически, без ручной настройки оборудования.

1. В Home Assistant откройте Settings > Apps > App store и добавьте https://github.com/grablo/grablo-spot-hass-addons в разделе Repositories меню в правом верхнем углу. Кнопка ниже сразу открывает окно добавления репозитория.
2. Найдите Grablo Spot в магазине и нажмите Install.
3. После завершения установки нажмите Start.

Когда дополнение запущено, откройте локальный экран в браузере в той же сети по адресу http://<IP-адрес Home Assistant>:8127. Код настройки, который нужен при первом открытии, появляется на вкладке Log дополнения при его первом запуске. Подробнее см. в разделе Открытие локального экрана.

Docker

На мини-ПК, NAS и других хостах Docker установите Grablo как контейнер. Если у вас Home Assistant OS или Supervised, вместо этого рекомендуется дополнение, описанное выше.

git clone https://github.com/grablo/grablo-docker.git
cd grablo-docker
docker compose -f docker-compose.spot.yml up -d

Когда контейнер запущен, откройте локальный экран в браузере в той же сети по адресу http://<IP-адрес хоста Docker>:8127. Чтобы узнать код настройки, который нужен при первом открытии, выполните docker exec grablo cat /etc/grablo/local/setup_code.txt.

Идентификатор и данные хранятся в именованных томах, поэтому контейнер остается тем же компьютером после обновлений и пересоздания. Контейнер не обновляется сам: чтобы установить новую версию, выполните docker compose -f docker-compose.spot.yml pull, а затем docker compose -f docker-compose.spot.yml up -d. Подробнее см. в руководстве по установке.

Прямая установка (.deb)

Пользователи, знакомые с Linux, могут скачать пакет .deb для своей архитектуры (ARM64/x64) и установить его напрямую. В графической среде откройте файл .deb в файловом менеджере, чтобы установить его; в командной строке скопируйте пакет на компьютер и выполните sudo apt install -y ./grablo-spot*.deb. После установки Grablo запускается как системная служба и автоматически стартует при загрузке, вход в систему не требуется.