Cài đặt

Grablo IoT Core chạy trên Windows, macOS và nhiều thiết bị Linux như Raspberry Pi, Jetson và Radxa. Tất cả tệp cài đặt đều có trên trang tải xuống.

Các máy tính bo mạch đơn được hỗ trợ gồm Raspberry Pi 3/4/5 và Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin) và Radxa Rock (5A, 5B, 5C, Zero 3W). Bạn cần phần cứng để thực sự chạy dự án, nhưng vẫn có thể tạo dự án khi chưa có phần cứng.

Windows và macOS

Tải tệp cài đặt (Windows: .exe, macOS: .pkg) từ trang tải xuống, chạy tệp và làm theo hướng dẫn. Grablo tự động khởi động khi cài đặt xong.

Ảnh đĩa cài sẵn (Raspberry Pi)

Ghi ảnh Raspberry Pi OS đã cài sẵn Grablo vào thẻ SD. Grablo tự động khởi động dưới dạng dịch vụ hệ thống khi máy bật, nên đây là cách đơn giản nhất cho người mới bắt đầu. Có hai bản: bản đầy đủ có giao diện desktop và bản lite chỉ có dòng lệnh (CLI).

Bạn cũng có thể ghi tệp ảnh đã tải xuống (.img.xz) bằng các công cụ thông dụng như balenaEtcher, nhưng nên dùng Raspberry Pi Imager vì công cụ này cho phép thiết lập Wi-Fi và tài khoản người dùng ngay khi ghi thẻ. Các bước và màn hình dưới đây dựa trên Raspberry Pi Imager 1.9. Chọn Use custom trong phần chọn hệ điều hành rồi chọn tệp ảnh.

Trong phần lưu trữ, chọn thẻ SD cần ghi và nhấp vào Next. Hộp thoại sẽ hỏi bạn có muốn áp dụng cài đặt tùy chỉnh hệ điều hành hay không.

Trong hộp thoại này, chọn Edit Settings để thiết lập trước tên máy chủ, tài khoản người dùng, Wi-Fi và vùng ngôn ngữ. Nếu thiết lập không dùng màn hình (headless) và không có cáp Ethernet, hãy nhớ cấu hình Wi-Fi. Nếu bạn không chỉnh sửa cài đặt, thông tin đăng nhập mặc định là grablo / grablo.

Bật SSH trên thẻ Services để truy cập thiết bị qua mạng mà không cần màn hình. Khi xong, nhấp vào Save, quay lại hộp thoại tùy chỉnh hệ điều hành và nhấp vào Yes. Sau khi bạn xác nhận cảnh báo rằng dữ liệu hiện có trên thẻ SD sẽ bị xóa, quá trình ghi sẽ bắt đầu.

Khi ghi xong, lắp thẻ SD vào Raspberry Pi rồi cắm nguồn. Grablo tự động khởi động dưới dạng dịch vụ hệ thống mỗi lần máy bật, không cần đăng nhập.

Add-on Home Assistant

Trên Home Assistant OS hoặc Supervised, hãy cài Grablo dưới dạng add-on. Add-on tự động kết nối với Home Assistant, không cần thiết lập phần cứng thủ công.

1. Trong Home Assistant, mở Settings > Apps > App store và thêm https://github.com/grablo/grablo-hass-addons vào mục Repositories trong menu ở góc trên bên phải. Nhấp vào nút bên dưới để mở trực tiếp hộp thoại kho lưu trữ.
2. Tìm Grablo IoT Core trong cửa hàng và nhấp vào Install.

Add-on không có giao diện riêng. Sau khi cài đặt, hãy kết nối với thiết bị từ ứng dụng web (app.grablo.co).

Docker

Trên máy tính mini, NAS và các máy chủ Docker khác, hãy cài Grablo dưới dạng container. Nếu bạn dùng Home Assistant OS hoặc Supervised, nên dùng add-on ở trên.

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

Danh tính và dữ liệu được lưu trong các volume có tên, nên container vẫn được nhận là cùng một thiết bị sau khi cập nhật hoặc tạo lại. Container không tự cập nhật; để áp dụng phiên bản mới, hãy chạy docker compose pull rồi docker compose up -d. Xem hướng dẫn cài đặt để biết chi tiết.

Cài đặt trực tiếp (.deb)

Người dùng quen với Linux có thể tải gói .deb cho kiến trúc của mình (ARM64/x64) và cài đặt trực tiếp. Trên máy tính có giao diện desktop, mở tệp .deb từ trình quản lý tệp để cài đặt; nếu dùng dòng lệnh, hãy sao chép gói vào thiết bị rồi chạy sudo apt install -y ./grablo*.deb. Sau khi cài đặt, Grablo chạy dưới dạng dịch vụ hệ thống và tự động khởi động khi máy bật, không cần đăng nhập.