commit 46ec97b051

Author: Robert Kaussow <mail@geeklabor.de>
Date:   Sat Apr 17 14:11:48 2021 +0200

    add option to install plugins

index.md

@@ -14,6 +14,7 @@ Setup [Home Assistant](https://www.home-assistant.io/) server. Open source home
   * [homeassistant_cmdline_override_enabled](#homeassistant_cmdline_override_enabled)
   * [homeassistant_container_name](#homeassistant_container_name)
   * [homeassistant_cpu_shares](#homeassistant_cpu_shares)
+  * [homeassistant_data_dir](#homeassistant_data_dir)
   * [homeassistant_devices](#homeassistant_devices)
   * [homeassistant_exclude_modemmanager](#homeassistant_exclude_modemmanager)
   * [homeassistant_exposed_ports](#homeassistant_exposed_ports)
@@ -24,6 +25,8 @@ Setup [Home Assistant](https://www.home-assistant.io/) server. Open source home
   * [homeassistant_networks](#homeassistant_networks)
   * [homeassistant_networks_applied](#homeassistant_networks_applied)
   * [homeassistant_pids_limit](#homeassistant_pids_limit)
+  * [homeassistant_plugin_dir](#homeassistant_plugin_dir)
+  * [homeassistant_plugins](#homeassistant_plugins)
   * [homeassistant_restart_policy](#homeassistant_restart_policy)
   * [homeassistant_security_opt](#homeassistant_security_opt)
   * [homeassistant_serial_device](#homeassistant_serial_device)
@@ -95,6 +98,14 @@ homeassistant_cpu_shares: _unset_
 homeassistant_cpu_shares: '1024'
 ```
 
+### homeassistant_data_dir
+
+#### Default value
+
+```YAML
+homeassistant_data_dir: /opt/homeassistant/config
+```
+
 ### homeassistant_devices
 
 Define required devices e.g. `/dev/ttyACM0`.
@@ -206,6 +217,34 @@ homeassistant_networks_applied:
 homeassistant_pids_limit: _unset_
 ```
 
+### homeassistant_plugin_dir
+
+#### Default value
+
+```YAML
+homeassistant_plugin_dir: /opt/homeassistant/config/www/plugins
+```
+
+### homeassistant_plugins
+
+Plugins will be downloaded to `homeassistant_plugin_dir` and need to be a single raw file.
+
+#### Default value
+
+```YAML
+homeassistant_plugins: []
+```
+
+#### Example usage
+
+```YAML
+homeassistant_plugins:
+ - name: button-card.js
+   url: https://github.com/custom-cards/button-card/releases/download/v3.4.2/button-card.js
+ - name: card-tools.js
+   url: https://raw.githubusercontent.com/thomasloven/lovelace-card-tools/11/card-tools.js
+```
+
 ### homeassistant_restart_policy
 
 #### Default value
@@ -272,7 +311,7 @@ Define required docker volumes.
 
 ```YAML
 homeassistant_volumes:
-  - name: /opt/homeassistant/config
+  - name: '{{ homeassistant_data_dir }}'
     dest: /config
     bind: true
 ```