Installazione

Grablo Spot funziona su Windows, macOS e un'ampia gamma di dispositivi Linux come Raspberry Pi, Jetson e Radxa. Tutti i file di installazione sono disponibili nella pagina di download.

I computer a scheda singola supportati sono Raspberry Pi 3/4/5 e Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin) e Radxa Rock (5A, 5B, 5C, Zero 3W).

Windows e macOS

Scarica il programma di installazione (Windows: .exe, macOS: .pkg) dalla pagina di download, eseguilo e segui le istruzioni. Al termine dell'installazione Grablo si avvia automaticamente.

Immagine preinstallata (Raspberry Pi)

Scrivi su una scheda SD un'immagine di Raspberry Pi OS con Grablo preinstallato. Grablo si avvia automaticamente come servizio di sistema all'accensione: è l'opzione più semplice per chi inizia. Sono disponibili un'immagine completa con desktop e un'immagine lite solo CLI.

Il file immagine scaricato (.img.xz) può essere scritto anche con programmi generici come balenaEtcher, ma è consigliato Raspberry Pi Imager perché permette di configurare il Wi-Fi e l'account utente durante la scrittura della scheda. I passaggi e le schermate seguenti si basano su Raspberry Pi Imager 1.9. Nella scelta del sistema operativo seleziona Use custom e scegli il file immagine.

Nella scelta della memoria di archiviazione, seleziona la scheda SD su cui scrivere e fai clic su Next. Una finestra chiede se applicare le impostazioni di personalizzazione del sistema operativo.

In questa finestra, seleziona Edit Settings per preconfigurare nome host, account utente, Wi-Fi e impostazioni locali. Per una configurazione senza monitor e senza Ethernet, configura sempre il Wi-Fi. Se non hai modificato le impostazioni, l'accesso predefinito a Raspberry Pi OS è grablo / grablo.

Se attivi SSH nella scheda Services, puoi raggiungere il dispositivo dalla rete senza monitor. Al termine, fai clic su Save, torna alla finestra di personalizzazione e fai clic su Yes. Conferma l'avviso che i dati presenti sulla scheda SD verranno cancellati: la scrittura ha inizio.

Al termine della scrittura, inserisci la scheda SD nel Raspberry Pi e collega l'alimentazione. Grablo si avvia automaticamente come servizio di sistema a ogni accensione, senza bisogno di accedere.

Componente aggiuntivo per Home Assistant

Su Home Assistant OS o Supervised, installa Grablo come componente aggiuntivo. Il componente aggiuntivo si connette a Home Assistant automaticamente, senza configurazione manuale dell'hardware.

1. In Home Assistant, apri Impostazioni > Apps > App store e aggiungi https://github.com/grablo/grablo-spot-hass-addons in Repositories nel menu in alto a destra. Facendo clic sul pulsante qui sotto si apre direttamente la finestra dei repository.
2. Trova Grablo Spot nello store e fai clic su Install.
3. Al termine dell'installazione, fai clic su Start.

Quando il componente aggiuntivo è in esecuzione, apri la schermata locale in un browser sulla stessa rete all'indirizzo http://<indirizzo IP di Home Assistant>:8127. Il codice di configurazione richiesto la prima volta che la apri compare nella scheda Registro del componente aggiuntivo al suo primo avvio. Per i dettagli, vedi Aprire la schermata locale.

Docker

Su mini PC, NAS e altri host Docker, installa Grablo come container. Se usi Home Assistant OS o Supervised, è consigliato invece il componente aggiuntivo descritto sopra.

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

Quando il container è in esecuzione, apri la schermata locale in un browser sulla stessa rete all'indirizzo http://<indirizzo IP dell'host Docker>:8127. Esegui docker exec grablo cat /etc/grablo/local/setup_code.txt per trovare il codice di configurazione richiesto la prima volta che la apri.

L'identità e i dati sono conservati in volumi con nome, quindi il container resta lo stesso dispositivo anche dopo aggiornamenti e ricreazioni. Il container non si aggiorna da solo: per applicare una nuova versione esegui docker compose -f docker-compose.spot.yml pull seguito da docker compose -f docker-compose.spot.yml up -d. Per i dettagli, consulta la guida all'installazione.

Installazione diretta (.deb)

Chi ha familiarità con Linux può scaricare il pacchetto .deb per la propria architettura (ARM64/x64) e installarlo direttamente. Sul desktop, apri il file .deb dal file manager per installarlo; dalla riga di comando, copia il pacchetto sul dispositivo ed esegui sudo apt install -y ./grablo-spot*.deb. Una volta installato, Grablo funziona come servizio di sistema e si avvia automaticamente all'accensione, senza bisogno di accedere.