mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
Document mandatory emulated_hue port setting (#10289)
* Document mandatory emulated_hue port setting
Since 2019 August/September firmware updates for Echo and Echo Dot v1.
* Amazon Alexa/Echo emulated hue port doc changes
* ✏️ Tweaks
Co-authored-by: Franck Nijhof <frenck@addons.community>
This commit is contained in:
parent
9af4bd95c0
commit
9354ed8809
@ -55,9 +55,8 @@ emulated_hue:
|
||||
```yaml
|
||||
# Amazon Echo example configuration.yaml entry
|
||||
emulated_hue:
|
||||
host_ip: YOUR.HASSIO.IP.ADDRESS
|
||||
listen_port: 80
|
||||
# Alexa stopped working on different ports. Search for "Philipps Hue Bridge V1 (round)" in the Alexa App to discover devices.
|
||||
# Amazon Echo/Alexa stopped working on different ports. Search for "Philips Hue Bridge V1 (round)" in the Alexa App to discover devices.
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
@ -71,7 +70,7 @@ host_ip:
|
||||
required: false
|
||||
type: string
|
||||
listen_port:
|
||||
description: "The port the Hue bridge API web server will run on. This can be any free port on your system. However, all new Alexa devices require listen_port: 80."
|
||||
description: "The port the Hue bridge API web server will run on. This can be any free port on your system. However, all new Alexa devices require listen_port: 80. See `setcap` note below if this is set below `1024` when Home Assistant is ran as a non-root user."
|
||||
required: false
|
||||
type: integer
|
||||
default: 8300
|
||||
@ -146,16 +145,19 @@ These attributes used to be found under the `customize` section of `homeassistan
|
||||
|
||||
You can verify that the `emulated_hue` integration has been loaded and is responding by pointing a local browser to the following URL:
|
||||
|
||||
- `http://<HA IP Address>:8300/description.xml` - This URL should return a descriptor file in the form of an XML file.
|
||||
- `http://<HA IP Address>:8300/api/pi/lights` - This will return a list of devices, lights, scenes, groups, etc.. that `emulated_hue` is exposing to Alexa.
|
||||
- `http://<HA IP Address>:8300/description.xml` - This URL should return a descriptor file in the form of an XML file.
|
||||
- `http://<HA IP Address>:8300/api/pi/lights` - This will return a list of devices, lights, scenes, groups, etc.. that `emulated_hue` is exposing to Alexa.
|
||||
|
||||
For Google Home, verify that the URLs above are using port 80, rather than port 8300 (i.e. `http://<HA IP Address>:80/description.xml`).
|
||||
|
||||
For Amazon Alexa/Echo, verify that the URLs above are using port 80, rather than port 8300 (i.e. `http://<HA IP Address>:80/description.xml`). Since 2019-08 Amazon Echo firmware, Alexa no longer works with port 8300.
|
||||
|
||||
An additional step is required to run Home Assistant as a non-root user and use port 80 when using the AiO script. Execute the following command to allow `emulated_hue` to use port 80 as a non-root user.
|
||||
|
||||
```bash
|
||||
sudo setcap 'cap_net_bind_service=+ep' /srv/homeassistant/homeassistant_venv/bin/python3
|
||||
```
|
||||
|
||||
Please note that your path may be different depending on your installation method. For example, if you followed the [Virtualenv instructions](/docs/installation/virtualenv/), your path will be `/srv/homeassistant/bin/python3`.
|
||||
|
||||
### License
|
||||
|
Loading…
x
Reference in New Issue
Block a user