totaldebug.hassio

Ansible Role for Setting Up a HASSIO Server with ha CLI

Configuration • Features • Contributing • Author • Support • Donate • License

About

ansible-role-hassio is a reliable Ansible Role designed to set up HASSIO on your Ansible clients.

Hass.io is an operating system that simplifies the installation and updating of Home Assistant. It can be managed through the Home Assistant user interface, allows the creation and restoration of configuration snapshots, and can be easily enhanced with various add-ons like Google Assistant and Let’s Encrypt.

Note: Currently, this Ansible role supports only Debian 10, according to the HASSIO documentation. It may work on other operating systems, but I haven’t tested those.

Configuration

Installation

ansible-galaxy install totaldebug.hassio

Role Variables

Input	Default	Description
`hassio_user`	`hassio`	Default user for running HASSIO
`hassio_group`	`hassio`	Default group for running HASSIO
`supervisor`	`homeassistant/amd64-hassio-supervisor`	Docker image for the supervisor (varies with OS architecture)
`machine`	`qemux86-64`	Type of machine (options: qemux86, qemux86-64, armv6l, armv7l, aarch64)
`hassio_share`	`/usr/share/hassio`	Main location for configuration
`hassio_version`	`latest`	Specify this if you want a particular version
`hassio_config`	`/etc/hassio.json`	Configuration file for Hassio
`hassio_bin`	`/usr/sbin/hassio-supervisor`	Location of the HASSIO supervisor binary
`docker_bin`	`/usr/bin/docker`	Location of the Docker binary

Example Playbook

---

- name: Install HASSIO
  hosts: all
  become: yes
  gather_facts: no
  vars:
    - hassio_share: "/usr/share/hassio"   #Default
    - version: latest   #Default
  roles:
     - totaldebug.hassio

Features

	🔰
Install HASSIO	✔️
Install HASSIO supervisor service	✔️
Install HASSIO AppArmor service	✔️

Contributing

Have something interesting to share? Check out our contributing guidelines.

Versioning

This project follows semantic versioning.

In semantic versioning, the role contract is defined by the role variables.

Breaking changes or those needing user action will increase the major version. This includes changes to default variable values.
Changes that add features but don’t require user action will increase the minor version.
Bug fixes will increase the patch version.