https://github.com/monolithprojects/ansible-homeassistant_compliance
Ansible Role to configure Debian 11 Operating System to make it compliant with Home Assistant Supervisor
https://github.com/monolithprojects/ansible-homeassistant_compliance
ansible ansible-role debian home-assistant home-automation homeassistant system
Last synced: about 2 months ago
JSON representation
Ansible Role to configure Debian 11 Operating System to make it compliant with Home Assistant Supervisor
- Host: GitHub
- URL: https://github.com/monolithprojects/ansible-homeassistant_compliance
- Owner: MonolithProjects
- License: mit
- Created: 2022-11-26T19:56:51.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-28T16:40:32.000Z (11 months ago)
- Last Synced: 2025-07-28T18:36:14.656Z (11 months ago)
- Topics: ansible, ansible-role, debian, home-assistant, home-automation, homeassistant, system
- Homepage: https://galaxy.ansible.com/monolithprojects/homeassistant_compliance
- Size: 30.3 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Home Assistant Supervisor compliance
[](https://galaxy.ansible.com/monolithprojects/homeassistant_compliance)
[](https://galaxy.ansible.com/monolithprojects/homeassistant_compliance)
[](https://galaxy.ansible.com/monolithprojects/homeassistant_compliance)
[](https://github.com/MonolithProjects/ansible-homeassistant_compliance/actions/workflows/test.yml)
[](https://github.com/MonolithProjects/ansible-homeassistant_compliance/blob/main/LICENSE)
This role will make Debian 11 Operating System compliant with [Home Assistant](https://www.home-assistant.io/) 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](https://www.home-assistant.io/more-info/unsupported/os/))
* 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`
```yaml
---
# 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.
```yaml
---
- 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