HA Install Home Assistant

How to Install Home Assistant on LinuxBox

Here is the official document for installing Home Assistant Core on Linux: install-home-assistant-core-document

The ThirdReality dev team provides a faster way to install Home Assistant Core in 8–10 minutes via USB.

Step 1: Prepare a USB Stick

Format an empty USB stick to FAT32.

Step 2: Copy the deb files to the USB Stick

The deb files are built by the ThirdReality dev team. Download them from LinuxBox-Installer:

• python3_3.13.11.deb Download
• hacore-config_2025.10.0.deb Download
• hacore_2025.12.0.deb Download
• otbr-agent_2025.08.25.deb Download
• zigbee-mqtt_2.7.0-rc.deb Download

(Note: Versions may be updated in the future.)

Put them into the folder R3Install on the USB stick.

Step 3: Insert the USB Stick

Insert the USB stick into LinuxBox. Wait for the LED to turn to green blinking.

Step 4: Wait for Installation to Complete

When the LED turns to black (off), the installation is finished.

⚠️ Note: If USB software installation and WiFi setup are done sequentially, it is recommended to reboot the device.

Step 5: Connect to WiFi and Start Services

Connect the LinuxBox to WiFi using the 3R-Installer app: How to connect LinuxBox to WiFi

Or via terminal command:

nmcli device wifi connect <SSID> password <PSK>

Then start the services:

systemctl start home-assistant.service
systemctl start matter-server.service

Note: The default credentials are:

• Username: root
• Password: shushi16888

These credentials are only needed when connecting via SSH. If using a USB Debug board, no login is required.

For more information, refer to the Home Assistant official pages: Onboarding