Ansible Collection - Smarthome

Effortlessly connect your IoT infrastructure to Apple Home ✨

Description

This collection is a set of Ansible roles, aiming to simplify the deployment and configuration of HomeAssistant, Zigbee2MQTT and Mosquitto, making them ready to connect to Apple Home.

Requirements

• A ZigBee Adapter.
• Docker. Please refer to ansible-role-docker to install it with Ansible.

Installation

ansible-galaxy collection install artyorsh.smarthome

Usage

1. Find the ZigBee adapter
2. Run the playbook
3. Open HomeAssistant frontend and complete the setup (localhost:8123)
4. Enable the MQTT integration (broker: "mosquitto", port: 1883)
5. Open Zigbee2MQTT frontend and pair the devices (localhost:8124)
6. Restart HomeAssistant
7. Pair with Apple Home (starting from step 1)

For a real-world usage example, see my infra playbooks.

Example Playbook

- hosts: localhost

  vars:
    smarthome_zigbee_adapter: /dev/ttyUSB0
    smarthome_user: { name: "myuser", password: "changeme" }
    # homeassistant_mdns_host_network_interface: wlan0 # running on wlan?

  roles:
    - artyorsh.smarthome.smarthome

By default, HomeAssistant and Zigbee2MQTT containers are deployed on ports 8123 and 8124.

Configuration

• The smarthome role is a shortcut to deploy everything in one go
• Please refer to the role documentation pages for more configuration options:
  • homeassistant
  • zigbee2mqtt
  • mosquitto

License

MIT