(Replace the filename with the specific one you downloaded) . Verifying the Installation
Without this agent, your installation will likely be flagged as "Unsupported," and certain features managed by the Supervisor may fail to function correctly. Prerequisites for Installation
Before downloading the agent, ensure your system has the necessary dependencies installed. From your terminal, run: sudo apt update && sudo apt install jq wget curl udisks2 libglib2.0-bin network-manager dbus apparmor -y How to Download and Install the OS Agent (Replace the filename with the specific one you downloaded)
You must download the file that matches your CPU architecture:
Understanding and Installing the Home Assistant OS Agent The Home Assistant OS Agent is a critical component for users running a installation on generic Linux systems (typically Debian). It acts as a bridge, allowing the Home Assistant Supervisor to communicate directly with the host operating system to manage hardware and system-level tasks. From your terminal, run: sudo apt update &&
You can find the latest version on the official OS Agent GitHub Releases page . Use the following command structure to download it (replace the version and architecture as needed): # Example for x86_64 architecture wget https://github.com Use code with caution.
If successful, you will see a detailed output showing the interface and the current version of the agent, confirming that the Supervisor can now communicate with your host OS. Guide: Installing HA Supervised on Debian (Official) Distro Use the following command structure to download it
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os Use code with caution.
The wget command is the standard way to retrieve the specific Debian (.deb) package required for your hardware architecture. 1. Identify Your Architecture
Note: Always check the GitHub page for the current version number to ensure you are downloading the most recent supported release. 3. Install the Package Once downloaded, install the package using dpkg : sudo dpkg -i os-agent_1.6.0_linux_x86_64.deb Use code with caution.