Instalação

O Grablo IoT Core funciona no Windows, no macOS e em vários dispositivos Linux, como Raspberry Pi, Jetson e Radxa. Todos os arquivos de instalação estão disponíveis na página de download.

Os computadores de placa única compatíveis incluem Raspberry Pi 3/4/5 e Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin) e Radxa Rock (5A, 5B, 5C, Zero 3W). O hardware é necessário para executar os projetos de fato, mas você pode criar projetos sem ele.

Windows e macOS

Baixe o instalador (Windows: .exe, macOS: .pkg) na página de download, execute-o e siga as instruções. O Grablo é iniciado automaticamente quando a instalação termina.

Imagem pré-instalada (Raspberry Pi)

Grave em um cartão SD uma imagem do Raspberry Pi OS com o Grablo pré-instalado. O Grablo é iniciado automaticamente como serviço do sistema na inicialização, o que torna esta a opção mais simples para quem está começando. Há duas versões: uma imagem completa, com área de trabalho, e uma imagem lite, somente com CLI.

O arquivo de imagem baixado (.img.xz) também pode ser gravado com gravadores de imagem comuns, como o balenaEtcher, mas recomendamos o Raspberry Pi Imager, pois ele permite configurar o Wi-Fi e a conta de usuário durante a gravação do cartão. As etapas e as telas abaixo se baseiam no Raspberry Pi Imager 1.9. Selecione Use custom na seleção do sistema operacional e escolha o arquivo de imagem.

Em armazenamento, selecione o cartão SD de destino e clique em Next. Uma caixa de diálogo pergunta se as configurações de personalização do sistema operacional devem ser aplicadas.

Nessa caixa de diálogo, selecione Edit Settings para configurar antecipadamente o nome do host, a conta de usuário, o Wi-Fi e a localidade. Para uma instalação sem monitor e sem Ethernet, não deixe de configurar o Wi-Fi. Se você não editou as configurações, o login padrão é grablo / grablo.

Ativar o SSH na guia Services permite acessar o dispositivo pela rede sem monitor. Quando terminar, clique em Save, volte à caixa de diálogo de personalização do sistema operacional e clique em Yes. Confirme o aviso de que os dados existentes no cartão SD serão apagados para iniciar a gravação.

Quando a gravação terminar, insira o cartão SD no Raspberry Pi e conecte a energia. O Grablo é iniciado automaticamente como serviço do sistema a cada inicialização, sem exigir login.

Complemento do Home Assistant

No Home Assistant OS ou Supervised, instale o Grablo como complemento. O complemento se conecta ao Home Assistant automaticamente, sem configuração manual de hardware.

1. No Home Assistant, abra Settings > Apps > App store e adicione https://github.com/grablo/grablo-hass-addons em Repositories, no menu do canto superior direito. Clicar no botão abaixo abre diretamente a caixa de diálogo do repositório.
2. Encontre Grablo IoT Core na loja e clique em Install.

O complemento não tem interface própria. Depois de instalá-lo, conecte-se ao dispositivo pelo app web (app.grablo.co).

Docker

Em mini PCs, NAS e outros hosts Docker, instale o Grablo como contêiner. Se você usa o Home Assistant OS ou Supervised, recomendamos o complemento acima.

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

A identidade e os dados ficam em volumes nomeados, então o contêiner continua sendo o mesmo dispositivo após atualizações e recriações. O contêiner não se atualiza sozinho; aplique uma nova versão com docker compose pull seguido de docker compose up -d. Consulte o guia de instalação para mais detalhes.

Instalação direta (.deb)

Usuários familiarizados com Linux podem baixar o pacote .deb da sua arquitetura (ARM64/x64) e instalá-lo diretamente. Na área de trabalho, abra o arquivo .deb no gerenciador de arquivos para instalá-lo; na linha de comando, copie o pacote para o dispositivo e execute sudo apt install -y ./grablo*.deb. Depois de instalado, o Grablo é executado como serviço do sistema e é iniciado automaticamente na inicialização, sem exigir login.