diff --git a/docs/add-ons/configuration.md b/docs/add-ons/configuration.md index 2bca8922..e3e0a71c 100644 --- a/docs/add-ons/configuration.md +++ b/docs/add-ons/configuration.md @@ -121,10 +121,10 @@ The configuration for an add-on is stored in `config.json`. | boot | string | yes | `auto` by system and manual or only `manual`. | ports | dict | no | Network ports to expose from the container. Format is `"container-port/type": host-port`. If host-port is `null` then the mapping is disabled. | ports_description | dict | no | Network ports description mapping. Format is `"container-port/type": "description of this port"`. -| host_network | bool | no | If that is `true`, the add-on run on host network. +| host_network | bool | no | If `true`, the add-on runs on host network. | host_ipc | bool | no | Default `false`. Allow to share the IPC namespace with others. | host_dbus | bool | no | Default `false`. Map the host D-Bus service into the add-on. -| host_pid | bool | no | Default `false`. Allow to run container on host PID namespace. Work only for not protected add-ons. +| host_pid | bool | no | Default `false`. Allow to run container on host PID namespace. Works only for not protected add-ons. | devices | list | no | Device list to map into the add-on. Format is: `::`. E.g., `/dev/ttyAMA0:/dev/ttyAMA0:rwm` | udev | bool | no | Default `false`. Set this `true`, if your container runs an udev process of its own. | auto_uart | bool | no | Default `false`. Auto mapping all UART/serial device from host into add-on. @@ -132,37 +132,37 @@ The configuration for an add-on is stored in `config.json`. | hassio_role | str | no | Default `default`. Role-based access to Supervisor API. Available: `default`, `homeassistant`, `backup`, `manager` or `admin` | hassio_api | bool | no | This add-on can access the Supervisor's REST API. Use `http://supervisor`. | homeassistant_api | bool | no | This add-on can access to the Home Assistant REST API proxy. Use `http://supervisor/core/api`. -| docker_api | bool | no | Allow read-oly access to docker API for add-on. Work only for not protected add-ons. +| docker_api | bool | no | Allow read-oly access to docker API for add-on. Works only for not protected add-ons. | privileged | list | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE`, `SYS_RESOURCE`, `SYS_PTRACE`, `SYS_MODULE` or `DAC_READ_SEARCH` -| full_access | bool | no | Give full access to hardware like the privileged mode in docker. Work only for not protected add-ons. +| full_access | bool | no | Give full access to hardware like the privileged mode in docker. Works only for not protected add-ons. | apparmor | bool/string | no | Enable or disable AppArmor support. If it is enable, you can also use custom profiles with the name of the profile. | map | list | no | List of maps for additional Home Assistant folders. Possible values: `config`, `ssl`, `addons`, `backup` or `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. | environment | dict | no | A dictionary of environment variable to run add-on. -| audio | bool | no | Boolean. Mark this add-on to use internal an audio system. We map a working PulseAudio setup into container. If you application did not support PulseAudio, you need maybe install: Alpine Linux `alsa-plugins-pulse` or Debian/Ubuntu `libasound2-plugins`. +| audio | bool | no | Boolean. Mark this add-on to use internal audio system. We map a working PulseAudio setup into container. If your application does not support PulseAudio, you may need to install: Alpine Linux `alsa-plugins-pulse` or Debian/Ubuntu `libasound2-plugins`. | video | bool | no | Boolean. Mark this add-on to use the internal video system. All available devices will be mapped into the add-on. -| gpio | bool | no | Boolean. If this is set to `true`, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some library need also `/dev/mem` and `SYS_RAWIO` for read/write access to this device. On system with AppArmor enabled, you need disable AppArmor or better for security, provide you own profile for the add-on. +| gpio | bool | no | Boolean. If this is set to `true`, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some libraries also need `/dev/mem` and `SYS_RAWIO` for read/write access to this device. On systems with AppArmor enabled, you need to disable AppArmor or provide you own profile for the add-on, which is better for security. | devicetree | bool | no | Boolean. If this is set to True, `/device-tree` will map into add-on. | kernel_modules | bool | no | Map host kernel modules and config into add-on (readonly). -| stdin | bool | no | Boolean. If that is enable, you can use the STDIN with Home Assistant API. -| legacy | bool | no | Boolean. If the Docker image have no `hass.io` labels, you can enable the legacy mode to use the config data. +| stdin | bool | no | Boolean. If enabled, you can use the STDIN with Home Assistant API. +| legacy | bool | no | Boolean. If the Docker image has no `hass.io` labels, you can enable the legacy mode to use the config data. | options | dict | yes | Default options value of the add-on. | schema | dict | yes | Schema for options value of the add-on. It can be `false` to disable schema validation and use custom options. | image | string | no | For use with Docker Hub and other container registries. -| timeout | integer | no | Default 10 (second). The timeout to wait until the Docker daemon is done or will be killed. +| timeout | integer | no | Default 10 (seconds). The timeout to wait until the Docker daemon is done or will be killed. | tmpfs | string | no | Mount a tmpfs filesystem in `/tmpfs`. Valid format for this option is : `size=XXXu,uid=N,rw`. Size is mandatory, valid units (`u`) are `k`, `m`, `g` and `XXX` has to be replaced by a number. `uid=N` (with `N` the uid number) and `rw` are optional. -| discovery | list | no | A list of services they this add-on allow to provide for Home Assistant. Currently supported: `mqtt` -| services | list | no | A list of services they will be provided or consumed with this add-on. Format is `service`:`function` and functions are: `provide` (this add-on can provide this service), `want` (this add-on can use this service) or `need` (this add-on need this service to work correctly). +| discovery | list | no | A list of services that this add-on provides for Home Assistant. Currently supported: `mqtt` +| services | list | no | A list of services that will be provided or consumed with this add-on. Format is `service`:`function` and functions are: `provide` (this add-on can provide this service), `want` (this add-on can use this service) or `need` (this add-on need this service to work correctly). | auth_api | bool | no | Allow access to Home Assistant user backend. | ingress | bool | no | Enable the ingress feature for the add-on. -| ingress_port | integer | no | Default `8099`. For Add-ons they run on host network, you can use `0` and read the port later on API. +| ingress_port | integer | no | Default `8099`. For add-ons that run on the host network, you can use `0` and read the port later via API. | ingress_entry | string | no | Modify the URL entry point from `/`. | panel_icon | string | no | Default: `mdi:puzzle`. MDI icon for the menu panel integration. -| panel_title | string | no | Default add-on name, but can modify with this options. +| panel_title | string | no | Default is the add-on name, but can be modified with this option. | panel_admin | bool | no | Default `true`. Make menu entry only available with admin privileged. -| snapshot_exclude | list | no | List of file/path with glob support they are excluded from snapshots. -| advanced | bool | no | Default `false`. Make addon visible on simple mode or not. +| snapshot_exclude | list | no | List of file/path (with glob support) that are excluded from snapshots. +| advanced | bool | no | Default `false`. Make addon visible in simple mode. | stage | string | no | Default `stable`. Flag add-on with follow attribute: `stable`, `experimental` or `deprecated` -| init | bool | no | Default `true`. Make it possible to disable the Docker default system init because the image have his own init system. +| init | bool | no | Default `true`. Disable the Docker default system init. Use this if the image has its own init system. ### Options / Schema