Here is the official document of how to install home assistant core on the Linux platform: install-home-assistant-core-document

Thirdreality dev team supply a new way to install home assistant core in 8-10 minutes.

The deb file is made by the ThirdReality dev team.

You can download the deb file from LinuxBox-Installer

(Note: May be updated in future versions)

put them into the Folder R3Install

You can connect the LinuxBox to WIFI by 3R-Installer.app: How-to-connect-the-Linuxbox-to-WIFI

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

Or by a 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

If you are using a USB Debug board for direct connection, no username or password is required. These credentials are only needed when connecting via SSH remote login.

More information please refer to homeassistant official pages: OnBoarding

There are two main ways to support the Zigbee protocol in Home Assistant:

• ZHA method
• Zigbee2MQTT method

There are also two main approaches to adding Zigbee devices:

• Using a web browser (WebView)
• Using the Home Assistant App

• Ensure the LinuxBox is connected to the network and you know the Zigbee device's IP address.
• Enter http://<ip_address>:8123 in your browser to access Home Assistant.
• On the Home Assistant homepage, click Setting → Device & Service → Add Integration, type "zha" in the Select brand dialog, and then add the Zigbee device.
• Follow the instructions for your specific Zigbee device to complete the pairing process on the device itself.

• The app can automatically discover Home Assistant IP addresses on the local network.
• If you have previously connected to another Home Assistant, it is recommended to delete the old configuration before adding a new one.
• In the app, click the the top left menu icon → Setting → Device & Service → Add Integration, type "zha" in the Select brand dialog, and add the Zigbee device.

• Follow the instructions for your specific Zigbee device to complete the pairing process on the device itself.

Before operating Zigbee devices, make sure the LinuxBox is connected to the network and you know the Zigbee device's IP address.

Unlike the web browser method, the app can automatically discover Home Assistant IP addresses on the local network.

Currently, Matter over WiFi devices can be added via the Home Assistant App.

• The app can automatically discover Home Assistant IP addresses on the local network.
• If you have previously connected to another Home Assistant, it is recommended to delete the old configuration before adding a new one.
• In the app, go to the top left menu icon → Setting → Device & Service → Add Integration → Add Matter device → "No, it's new"

• According to the Matter device’s instructions, put the device into pairing mode.
• Choose "Open Camera here" or "Setup without QR code" to add the Matter device’s QR code or manual code.

• Follow the app prompts to complete device addition.

⚠️This is not a standard method and may not work for all Matter devices. If adding fails, you can retry once. If it fails again, you should use the Home Assistant App.

• Make sure the LinuxBox is connected to the network and you know its IP address.
• In your browser, enter http://<ip_address>:5580 to access the Python Matter Server.
• In the Python Matter Server, click the "Commission node" button.
• In the dialog, click "Commission new WiFi device".
• For the first operation, you need to enter the SSID and password of the WiFi where the LinuxBox is located.

• According to the Matter device’s instructions, put the device into pairing mode.
• Enter the Matter device’s manual code and click "Commission".

• Wait for the commissioning to complete.

Note: Adding Matter on Thread devices is relatively complex. The operations in the Companion App on Android phones are especially important—do not skip them!

• The app can automatically discover Home Assistant IP addresses on the local network.
• If you have previously connected to another Home Assistant, it is recommended to delete the old configuration before adding a new one.
• For Android phones, in the app, go to the top left menu icon → Companion App → Troubleshooting → Sync Thread credentials, and complete the sync.

• In the app, go to the top left menu icon → Setting → Device & Service → Add Integration → Add Matter device → "No, it's new"

• Before proceeding, it is recommended to follow the Matter device’s instructions to put it into pairing mode.
• Choose "Open Camera here" or "Setup without QR code" to add the Matter device’s QR code or manual code.

• Follow the app prompts to complete device addition.

⚠️This is not a standard method and may not work for all Matter devices. If adding fails, you can retry once. If it fails again, you should use the Home Assistant App. If possible, contact the Matter device manufacturer for technical support.

• Make sure the LinuxBox is connected to the network and you know its IP address.
• In your browser, enter http://<ip_address>:8123 to access Home Assistant.
• In the app, go to the top left menu → Setting → Device & Service → Thread → CONFIGURE → Click the exclamation mark on "Preferred network" → COPY the string next to "Active dataset TLVs:" for later use.

• In your browser, enter http://<ip_address>:5580 to access the Python Matter Server.
• In the Python Matter Server, click the "Commission node" button.
• In the dialog, click "Commission new Thread device".
• For the first operation, you need to PASTE the current Thread dataset of the LinuxBox and click "Set Thread Dataset".

• According to the Matter device’s instructions, put the device into pairing mode.
• Enter the Matter device’s manual code and click "Commission".

• Wait for the commissioning to complete.