Installation

Grablo IoT Core runs on Windows, macOS, and a wide range of Linux devices such as Raspberry Pi, Jetson, and Radxa. All installation files are available on the download page.

Supported single-board computers include Raspberry Pi 3/4/5 and Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin), and Radxa Rock (5A, 5B, 5C, Zero 3W). Hardware is required to actually run projects, but projects can be created without it.

Windows and macOS

Download the installer (Windows: .exe, macOS: .pkg) from the download page, run it, and follow the instructions. Grablo starts automatically once installation completes.

Pre-installed Image (Raspberry Pi)

Write a Raspberry Pi OS image with Grablo pre-installed to an SD card. Grablo starts automatically as a system service on boot, making this the simplest option for first-time users. A full image with desktop and a CLI-only lite image are provided.

For the downloaded image file (.img.xz), Raspberry Pi Imager is recommended. Select Use custom in the operating system selection and choose the image file.

In the OS customisation window, select Edit Settings to pre-configure the hostname, user account, Wi-Fi, and locale. For a headless setup without Ethernet, be sure to configure Wi-Fi. If you did not edit the settings, the default login is grablo / grablo.

Home Assistant Add-on

On Home Assistant OS or Supervised, install Grablo as an add-on. The add-on connects to Home Assistant automatically, with no manual hardware setup.

1. In Home Assistant, open Settings > Apps > App store and add https://github.com/grablo/grablo-hass-addons under Repositories in the top-right menu. Clicking the button below opens the repository dialog directly.
2. Find Grablo IoT Core in the store and click Install.

The add-on has no UI of its own. After installing, connect to the device from the web app (app.grablo.co).

Docker

On mini PCs, NAS and other Docker hosts, install Grablo as a container. If you run Home Assistant OS or Supervised, the add-on above is recommended instead.

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

Identity and data are kept in named volumes, so the container remains the same device across updates and recreation. The container does not self-update; apply a new version with docker compose pull followed by docker compose up -d. See the install guide for details.

Direct Installation (.deb)

Users familiar with Linux can download the .deb package for their architecture (ARM64/x64) and install it directly, e.g. from the command line with sudo apt install -y ./grablo*.deb. Once installed, Grablo starts as a system service and launches automatically on boot.

After installing

The controller starts on its own once installation finishes. Connect it from the app and build your first rule, and you are ready.

1. Open Reflex in a browser or on your phone and sign in with your Grablo account.
2. Connect the controller you just installed from the top right. Controllers on the same network are found automatically.
3. Add a camera or a device, then create one rule.

Getting Started and Rules walk through each step.