---
title: homeassistant
type: docs
---

[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.homeassistant) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.homeassistant?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.homeassistant) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) 

Setup [Home Assistant](https://www.home-assistant.io/) server. Open source home automation that puts local control and privacy first.

* [Default Variables](#default-variables)
  * [homeassistant_base_dir](#homeassistant-base-dir)
  * [homeassistant_client_url](#homeassistant-client-url)
  * [homeassistant_cmdline_content](#homeassistant-cmdline-content)
  * [homeassistant_cmdline_override_enabled](#homeassistant-cmdline-override-enabled)
  * [homeassistant_conf_dir](#homeassistant-conf-dir)
  * [homeassistant_exclude_modemmanager](#homeassistant-exclude-modemmanager)
  * [homeassistant_extra_groups](#homeassistant-extra-groups)
  * [homeassistant_group](#homeassistant-group)
  * [homeassistant_http_bind_port](#homeassistant-http-bind-port)
  * [homeassistant_packages](#homeassistant-packages)
  * [homeassistant_serial_device](#homeassistant-serial-device)
  * [homeassistant_systemd_after](#homeassistant-systemd-after)
  * [homeassistant_tls_cert_path](#homeassistant-tls-cert-path)
  * [homeassistant_tls_cert_source](#homeassistant-tls-cert-source)
  * [homeassistant_tls_dhparam_path](#homeassistant-tls-dhparam-path)
  * [homeassistant_tls_dhparam_size](#homeassistant-tls-dhparam-size)
  * [homeassistant_tls_enabled](#homeassistant-tls-enabled)
  * [homeassistant_tls_key_path](#homeassistant-tls-key-path)
  * [homeassistant_tls_key_source](#homeassistant-tls-key-source)
  * [homeassistant_user](#homeassistant-user)
  * [homeassistant_user_home](#homeassistant-user-home)
  * [homeassistant_version](#homeassistant-version)
* [Dependencies](#dependencies)

---

## Default Variables

### homeassistant_base_dir

#### Default value

```YAML
homeassistant_base_dir: /opt/homeassistant
```

### homeassistant_client_url

#### Default value

```YAML
homeassistant_client_url: https://hassio.example.com
```

### homeassistant_cmdline_content

#### Default value

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

### 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

```YAML
homeassistant_cmdline_override_enabled: false
```

### homeassistant_conf_dir

#### Default value

```YAML
homeassistant_conf_dir: '{{ homeassistant_base_dir }}/config'
```

### 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

```YAML
homeassistant_exclude_modemmanager: false
```

### homeassistant_extra_groups

#### Default value

```YAML
homeassistant_extra_groups:
  - tty
  - dialout
```

### homeassistant_group

#### Default value

```YAML
homeassistant_group: '{{ homeassistant_user }}'
```

### homeassistant_http_bind_port

#### Default value

```YAML
homeassistant_http_bind_port: 8123
```

### homeassistant_packages

#### Default value

```YAML
homeassistant_packages: []
```

### homeassistant_serial_device

#### Default value

```YAML
homeassistant_serial_device:
  - vendor_id: '0000'
    product_id: xxxx
```

### homeassistant_systemd_after

#### Default value

```YAML
homeassistant_systemd_after:
  - network-online.target
```

### homeassistant_tls_cert_path

#### Default value

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

### homeassistant_tls_cert_source

#### Default value

```YAML
homeassistant_tls_cert_source: mycert.pem
```

### homeassistant_tls_dhparam_path

#### Default value

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

### homeassistant_tls_dhparam_size

#### Default value

```YAML
homeassistant_tls_dhparam_size: 2048
```

### homeassistant_tls_enabled

#### Default value

```YAML
homeassistant_tls_enabled: false
```

### homeassistant_tls_key_path

#### Default value

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

### homeassistant_tls_key_source

#### Default value

```YAML
homeassistant_tls_key_source: mykey.pem
```

### homeassistant_user

#### Default value

```YAML
homeassistant_user: homeassistant
```

### homeassistant_user_home

#### Default value

```YAML
homeassistant_user_home: /home/{{ homeassistant_user }}
```

### homeassistant_version

#### Default value

```YAML
homeassistant_version: 0.92.1
```

## Dependencies

None.