Penginstalan

Grablo Spot berjalan di Windows, macOS, dan berbagai perangkat Linux seperti Raspberry Pi, Jetson, dan Radxa. Semua file penginstalan tersedia di halaman unduhan.

Komputer papan tunggal yang didukung antara lain Raspberry Pi 3/4/5 dan Zero 2 W, NVIDIA Jetson (Nano, Orin Nano, AGX Orin), serta Radxa Rock (5A, 5B, 5C, Zero 3W).

Windows dan macOS

Unduh penginstal (Windows: .exe, macOS: .pkg) dari halaman unduhan, jalankan, lalu ikuti petunjuknya. Grablo dimulai secara otomatis setelah penginstalan selesai.

Image siap pakai (Raspberry Pi)

Tulis image Raspberry Pi OS yang sudah berisi Grablo ke kartu SD. Grablo dimulai secara otomatis sebagai layanan sistem saat booting, sehingga ini adalah pilihan paling mudah bagi pengguna baru. Tersedia image lengkap dengan desktop dan image lite yang hanya berisi CLI.

File image yang diunduh (.img.xz) juga dapat ditulis dengan aplikasi penulis image umum seperti balenaEtcher, tetapi Raspberry Pi Imager lebih disarankan karena Anda dapat mengatur Wi-Fi dan akun pengguna saat menulis kartu. Langkah dan tampilan di bawah ini berdasarkan Raspberry Pi Imager 1.9. Pilih Use custom di pilihan sistem operasi, lalu pilih file image.

Di bagian penyimpanan, pilih kartu SD tujuan, lalu klik Next. Dialog akan menanyakan apakah pengaturan kustomisasi OS ingin diterapkan.

Di dialog ini, pilih Edit Settings untuk mengatur nama host, akun pengguna, Wi-Fi, dan lokal terlebih dahulu. Untuk penyiapan headless tanpa Ethernet, pastikan Wi-Fi sudah diatur. Jika Anda tidak mengubah pengaturan, login default Raspberry Pi OS adalah grablo / grablo.

Mengaktifkan SSH di tab Services memungkinkan Anda mengakses perangkat melalui jaringan tanpa monitor. Setelah selesai, klik Save, kembali ke dialog kustomisasi OS, lalu klik Yes. Konfirmasi peringatan bahwa data yang ada di kartu SD akan dihapus, lalu penulisan dimulai.

Setelah penulisan selesai, masukkan kartu SD ke Raspberry Pi dan sambungkan daya. Grablo dimulai secara otomatis sebagai layanan sistem setiap kali booting, tanpa perlu login.

Add-on Home Assistant

Di Home Assistant OS atau Supervised, instal Grablo sebagai add-on. Add-on ini terhubung ke Home Assistant secara otomatis, tanpa penyiapan hardware manual.

1. Di Home Assistant, buka Settings > Apps > App store dan tambahkan https://github.com/grablo/grablo-spot-hass-addons di Repositories pada menu kanan atas. Mengklik tombol di bawah ini langsung membuka dialog repositori.
2. Cari Grablo Spot di store, lalu klik Install.
3. Setelah penginstalan selesai, klik Start.

Setelah add-on berjalan, buka layar lokal di browser pada jaringan yang sama di http://<Home Assistant IP address>:8127. Kode penyiapan yang diperlukan saat pertama kali membukanya muncul di tab Log add-on saat add-on pertama kali dimulai. Untuk detailnya, lihat Membuka layar lokal.

Docker

Di mini PC, NAS, dan host Docker lainnya, instal Grablo sebagai container. Jika Anda menjalankan Home Assistant OS atau Supervised, sebaiknya gunakan add-on di atas.

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

Setelah container berjalan, buka layar lokal di browser pada jaringan yang sama di http://<Docker host IP address>:8127. Jalankan docker exec grablo cat /etc/grablo/local/setup_code.txt untuk melihat kode penyiapan yang diperlukan saat pertama kali membukanya.

Identitas dan data disimpan di named volume, sehingga container tetap dikenali sebagai perangkat yang sama setelah pembaruan maupun dibuat ulang. Container tidak memperbarui dirinya sendiri; terapkan versi baru dengan docker compose -f docker-compose.spot.yml pull lalu docker compose -f docker-compose.spot.yml up -d. Lihat panduan penginstalan untuk detailnya.

Penginstalan langsung (.deb)

Pengguna yang terbiasa dengan Linux dapat mengunduh paket .deb untuk arsitekturnya (ARM64/x64) dan menginstalnya secara langsung. Di desktop, buka file .deb dari pengelola file untuk menginstalnya; dari command line, salin paket ke perangkat lalu jalankan sudo apt install -y ./grablo-spot*.deb. Setelah terinstal, Grablo berjalan sebagai layanan sistem dan dimulai secara otomatis saat booting, tanpa perlu login.