설치

Grablo IoT Core 는 Windows, macOS, 그리고 라즈베리파이·Jetson·Radxa 등 다양한 리눅스 기기에서 실행할 수 있습니다. 모든 설치 파일은 다운로드 페이지에서 받을 수 있습니다.

지원 싱글보드 컴퓨터는 라즈베리파이 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 가 자동으로 실행됩니다.

프리인스톨 이미지 (라즈베리파이)

Grablo 가 미리 설치된 라즈베리파이 OS 이미지를 SD 카드에 기록하여 사용하는 방법입니다. 부팅과 동시에 Grablo 가 시스템 서비스로 자동 시작되므로 처음 사용하는 경우에 가장 간편합니다. 데스크톱이 포함된 전체 이미지와 CLI 전용 라이트 이미지를 제공합니다.

내려받은 이미지 파일(.img.xz)은 Raspberry Pi Imager 로 기록하는 것을 권장합니다. 운영체제 선택에서 사용자 정의 사용을 클릭하고 이미지 파일을 선택합니다.

OS 커스터마이징 창에서 설정을 편집하기를 선택하면 호스트 이름, 사용자 계정, Wi-Fi, 로케일을 미리 설정할 수 있습니다. 모니터 없이(headless) 사용하면서 이더넷도 연결하지 않는 경우에는 반드시 Wi-Fi 를 설정합니다. 설정을 편집하지 않은 경우 초기 로그인 정보는 grablo / grablo 입니다.

Home Assistant 애드온

Home Assistant OS 또는 Supervised 환경에서는 애드온으로 설치합니다. 애드온으로 설치하면 Home Assistant 연동이 자동으로 구성되며, 별도의 하드웨어 설정이 필요하지 않습니다.

1. Home Assistant 에서 설정 > 앱 > 앱 스토어를 열고, 우측 상단 메뉴의 리포지토리에 https://github.com/grablo/grablo-hass-addons 를 추가합니다. 아래 버튼을 클릭하면 리포지토리 추가 화면이 바로 열립니다.
2. 스토어에서 Grablo IoT Core 를 찾아 설치를 클릭합니다.

애드온에는 자체 화면이 없습니다. 설치 후 웹 앱(app.grablo.co)에서 디바이스로 연결하여 사용합니다.

Docker

미니PC, NAS 등 Docker 환경에서는 컨테이너로 설치합니다. Home Assistant OS 또는 Supervised 를 사용 중이라면 위의 애드온 설치를 권장합니다.

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

데이터와 디바이스 식별 정보는 명명된 볼륨에 보관되어 컨테이너를 다시 만들어도 같은 디바이스로 유지됩니다. 컨테이너는 자동으로 업데이트되지 않으며, 새 버전은 docker compose pull 실행 후 docker compose up -d 로 적용합니다. 자세한 내용은 설치 가이드를 참고합니다.

직접 설치 (.deb)

리눅스 환경에 익숙한 경우 아키텍처(ARM64/x64)에 맞는 .deb 패키지를 받아 직접 설치할 수 있습니다. 명령줄에서는 sudo apt install -y ./grablo*.deb 를 실행합니다. 설치가 완료되면 Grablo 가 시스템 서비스로 시작되며 부팅 시 자동 실행됩니다.

연결 및 실행

디바이스 연결

1. 프로젝트를 연 상태에서 우측 상단의 연결 버튼을 클릭합니다.

   

2. 처음 사용하는 경우 디바이스 목록이 비어 있습니다. 첫 번째 디바이스 추가를 클릭합니다.

   

3. 같은 네트워크(공유기·Wi-Fi)에 연결된 디바이스는 자동으로 검색됩니다. 목록에서 디바이스를 선택하면 이름과 ID 가 자동으로 입력되며, 원하는 이름으로 변경한 뒤 디바이스 추가를 클릭합니다. 다른 네트워크에 있는 디바이스는 16자리 디바이스 ID 를 직접 입력하여 추가합니다. 디바이스 ID 는 Windows·macOS 에서는 트레이 아이콘 → 정보에서, 리눅스에서는 systemctl status grablo 명령으로 확인합니다.

   

4. 목록에서 디바이스를 선택하고 연결을 클릭합니다. 추가된 디바이스는 계정에 저장되어 이후 다른 네트워크에서도 연결할 수 있습니다.

   

5. 연결에 성공하면 디바이스 아이콘에 녹색 점이 표시됩니다. 아이콘에 마우스를 올리면 연결 정보를 확인할 수 있습니다.

   

프로젝트는 마지막 연결 상태를 기억하므로 이후에는 자동으로 연결됩니다. 연결을 해제하려면 디바이스 아이콘을 다시 클릭합니다.

실행

디바이스에 연결되면 상단에 RUN/STOP 버튼이 표시됩니다. RUN 을 클릭하면 모든 프로젝트 설정이 디바이스로 전송되고 로직이 실행됩니다. 이후에는 웹 브라우저를 닫아도 디바이스가 독립적으로 계속 동작합니다.