xoxys.homeassistant_docker/README.md

xoxys.homeassistant

Role to setup Homeassistant

Table of content

• Default Variables
  • homeassistant_version
  • homeassistant_user
  • homeassistant_user_home
  • homeassistant_group
  • homeassistant_extra_groups
  • homeassistant_systemd_after
  • homeassistant_base_dir
  • homeassistant_conf_dir
  • homeassistant_packages
  • homeassistant_http_bind_port
  • homeassistant_client_url
  • homeassistant_tls_enabled
  • homeassistant_tls_dhparam_path
  • homeassistant_tls_dhparam_size
  • homeassistant_tls_cert_path
  • homeassistant_tls_key_path
  • homeassistant_tls_cert_source
  • homeassistant_tls_key_source
  • homeassistant_cmdline_override_enabled
  • homeassistant_cmdline_content
  • homeassistant_exclude_modemmanager
  • homeassistant_serial_device
• Dependencies
• License
• Author

---

Default Variables

homeassistant_version

Default value

homeassistant_version: 0.92.1

homeassistant_user

Default value

homeassistant_user: homeassistant

homeassistant_user_home

Default value

homeassistant_user_home: /home/{{ homeassistant_user }}

homeassistant_group

Default value

homeassistant_group: '{{ homeassistant_user }}'

homeassistant_extra_groups

Default value

homeassistant_extra_groups:
  - tty
  - dialout

homeassistant_systemd_after

Default value

homeassistant_systemd_after:
  - network-online.target

homeassistant_base_dir

Default value

homeassistant_base_dir: /opt/homeassistant

homeassistant_conf_dir

Default value

homeassistant_conf_dir: '{{ homeassistant_base_dir }}/config'

homeassistant_packages

Default value

homeassistant_packages: []

homeassistant_http_bind_port

Default value

homeassistant_http_bind_port: 8123

homeassistant_client_url

Default value

homeassistant_client_url: https://hassio.example.com

homeassistant_tls_enabled

Default value

homeassistant_tls_enabled: false

homeassistant_tls_dhparam_path

Default value

homeassistant_tls_dhparam_path: '{{ homeassistant_base_dir }}/tls/dhparam.pem'

homeassistant_tls_dhparam_size

Default value

homeassistant_tls_dhparam_size: 2048

homeassistant_tls_cert_path

Default value

homeassistant_tls_cert_path: '{{ homeassistant_base_dir }}/tls/certs/mycert.pem'

homeassistant_tls_key_path

Default value

homeassistant_tls_key_path: '{{ homeassistant_base_dir }}/tls/private/mykey.pem'

homeassistant_tls_cert_source

Default value

homeassistant_tls_cert_source: mycert.pem

homeassistant_tls_key_source

Default value

homeassistant_tls_key_source: mykey.pem

homeassistant_cmdline_override_enabled

Override /boot/cmdline.txt with given conten. This can be necessary if you use searial hardware, but be careful! Wrong configuration may leave your system unusable!

Default value

homeassistant_cmdline_override_enabled: false

homeassistant_cmdline_content

Default value

homeassistant_cmdline_content: console=tty1 root=/dev/mmcblk0p3 rootfstype=ext4 elevator=deadline
  rootwait

homeassistant_exclude_modemmanager

Prevent ModemManger from binding to serial devices and therefor blocking controllers like a CC2531. Devices can be skipped by a udev rule.

Default value

homeassistant_exclude_modemmanager: false

homeassistant_serial_device

Default value

homeassistant_serial_device:
  - vendor_id: '0000'
    product_id: xxxx

Dependencies

None.

License

MIT

Author

xoxys