homeassistant_compliance

Home Assistant Supervisor compliance

Galaxy Quality Role version Role downloads molecule test License

This role will make Debian 11 Operating System compliant with Home Assistant Supervisor. It will fix all OS related Unsupported system warning messages coming from Home Assistant Supervisor.

Requirements

  • Operating System: Debian 11
    (Beside the Home Assistant OS Home Assistant team officialy support only Debian 11 (bullseye) to run the Supervisor. More here)

  • Run this role with root privilege (become: true)

  • This role will NOT install the Docker-CE. Therefore you need to resolve it prior running this Ansible role. I recommend to user Ansible role geerlingguy.docker.

Tested on

  • Debian 11

Role Variables

This is a copy of defaults/main.yml

---
# Enable Apparmor
ha_fix_apparmor: yes

# Install and enable DBUS
ha_fix_dbus: yes

# If Docker is older than minimal supported version, update to latest
ha_fix_docker: yes
ha_fix_docker_minimal: 20.10.17

# Uninstall LXC
ha_fix_lxc: yes

# Install Home Assistant OS Agent
ha_fix_osagent: yes
ha_fix_osagent_cpu_architecture: x86_64
ha_fix_osagent_download_repository: "home-assistant/os-agent"
ha_fix_osagent_version: latest

# Install and enable systemd-journal-remote
ha_fix_systemd_journal: yes

# Enable systemd-resolved
ha_fix_systemd_resolved: yes

# Revert CGroup to version 1
ha_fix_cgroup: yes

# Install and enable Network Manager
ha_fix_network_manager: yes

# Use following network config files when fixing Network Manager
# /etc/network/interfaces
ha_fix_network_manager_interfaces: |
  # This file is managed by Ansible

  source-directory /run/network/interfaces.d

  auto lo
  iface lo inet loopback

# /etc/NetworkManager/system-connections/default
ha_fix_network_manager_default: |
  # This file is managed by Ansible

  [connection]
  id=Supervisor default
  uuid=1c8d78bf-e4e0-4735-8dca-eb31635dba30
  type=802-3-ethernet
  llmnr=2
  mdns=2

  [ipv4]
  method=auto

  [ipv6]
  addr-gen-mode=stable-privacy
  method=auto

# /etc/NetworkManager/NetworkManager.conf
ha_fix_network_manager_conf: |
  # This file is managed by Ansible

  [main]
  dns=default
  plugins=keyfile
  autoconnect-retries-default=0
  rc-manager=file

  [keyfile]
  unmanaged-devices=type:bridge;type:tun;driver:veth

  [logging]
  backend=journal

Example Playbook

This Playbook will install Docker-CE and fix Home Assistant system warnings.

---
- name: Fix Home Assistant warnings
  hosts: homeassistant
  become: true
  roles:
    - role: geerlingguy.docker
    - role: monolithprojects.homeassistant_compliance

License

MIT

Author Information

Created in 2022 by Michal Muransky

About

This Ansible role configure Debian 11 Operating System to be complient with Home Assistant Supervisor.

Install
ansible-galaxy install MonolithProjects/ansible-homeassistant_compliance
GitHub repository
License
mit
Downloads
55709
Owner
Full-time Cloud Engineer, part-time adventurer