tech

Instalando Home Assistant no Debian 12

Instale o Home Assistant Supervised no Debian 12 com controle total do sistema. Este guia cobre desde a configuração do DNS até a instalação manual do OS Agent, resolução de dependências e ajustes finos para garantir funcionamento completo.

Pablo Murad

Pablo Murad

— 2 min read
Instalando Home Assistant no Debian 12
Tutorial de Instalação do Home Assistant Supervised no Debian 12

Instalação do Home Assistant Supervised no Debian 12

Este tutorial cobre o processo completo de instalação do Home Assistant Supervised no Debian 12, incluindo a resolução de problemas comuns que podem surgir durante o processo.

1. Atualize o sistema

apt update && apt upgrade -y

2. Configure o DNS corretamente

Se você estiver enfrentando erro Could not resolve host:

nano /etc/resolv.conf

Adicione o conteúdo:

nameserver 1.1.1.1
nameserver 8.8.8.8

3. Instale o Docker

curl -fsSL https://get.docker.com | sh

4. Baixe e instale o OS Agent


cd /usr/local/src
wget https://github.com/home-assistant/os-agent/releases/download/1.7.2/os-agent_1.7.2_linux_amd64.tar.gz
tar -xzf os-agent_1.7.2_linux_amd64.tar.gz
install -m 755 os-agent /usr/local/bin/os-agent

Crie o serviço systemd para o os-agent

Crie o arquivo:

nano /etc/systemd/system/io.hass.osagent.service

Conteúdo:

[Unit]
Description=OS Agent for Home Assistant
After=network.target

[Service]
ExecStart=/usr/local/bin/os-agent
Restart=on-failure

[Install]
WantedBy=multi-user.target

Configure o D-Bus


cat <<EOF > /etc/dbus-1/system.d/io.hass.osagent.conf
<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
  <policy user="root">
    <allow own="io.hass.os"/>
  </policy>
</busconfig>
EOF
  

systemctl daemon-reload
systemctl restart dbus
systemctl enable --now io.hass.osagent.service

5. Verifique com busctl

busctl introspect --system io.hass.os /io/hass/os

Se o nome io.hass.os aparecer com propriedades e interfaces, está funcionando.

6. Criando pacote fictício para os-agent com equivs


apt install equivs
cd /usr/local/src
equivs-control os-agent
nano os-agent
# Preencha o controle com nome, versão e mantenedor, e salve

Depois:

equivs-build os-agent
dpkg -i os-agent_1.7.2_all.deb

7. Baixe e instale o Home Assistant Supervised


wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
apt install ./homeassistant-supervised.deb

Durante a instalação, ele instalará dependências adicionais e configurará os serviços necessários. Ao final, você verá:

http://homeassistant.local:8123

Ou acesse via IP: http://SEU-IP:8123

Considerações finais

  • Evite executar em ambientes com serviços que manipulam a rede (como ModemManager).
  • Se algo falhar, verifique logs com journalctl -xe ou systemctl status.

Pronto! O Home Assistant Supervised está instalado e rodando no Debian 12.

Read more