jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Adding details for FreeNAS/BSD (#10972)

Browse Source 
* Adding details for FreeNAS/BSD

Adding the required commands for when people do a venv install on FreeNAS or FreeBSD, as explained by @atxbyea in the Discord server.

* Update emulated_hue.markdown

* Update emulated_hue.markdown
This commit is contained in:
Dubh Ad 2019-12-09 17:43:31 +00:00 committed by Franck Nijhof
parent 1adfb13afd
commit 144970a533
1 changed files with 29 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
source/_integrations/emulated_hue.markdown
View File

@ -145,14 +145,24 @@ 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>:80/description.xml` - This URL should return a descriptor file in the form of an XML file.
- `http://<HA IP Address>:80/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`).
Verify that the URLs above are using port 80, rather than port 8300 (i.e. `http://<HA IP Address>:80/description.xml`). Both Google Home and Amazon Alexa/Echo (as of the 2019-08 firmware) require port 80.
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.
### Platform specific instructions
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.
#### Hass.io and Docker
No further actions are required
#### Python venv
An additional step is required to run Home Assistant as a non-root user and use port 80.
##### Linux
On Linux systems (Ubuntu, Debian, etc) 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
@ -160,6 +170,20 @@ sudo setcap 'cap_net_bind_service=+ep' /srv/homeassistant/homeassistant_venv/bin
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`.
##### FreeBSD and FreeNAS
On FreeBSD based systems, including FreeNAS, execute the following to allow `emulated_hue` to use port 80 as a non-root user:
```bash
sysctl net.inet.ip.portrange.reservedhigh=0
```
You can make this persist by adding the following to `/etc/sysctl.conf`:
```bash
net.inet.ip.portrange.reservedhigh=0
```
### License
Much of this code is based on work done by Bruce Locke on his [ha-local-echo](https://github.com/blocke/ha-local-echo) project, originally released under the MIT License. The license is located [here](https://github.com/blocke/ha-local-echo/blob/b9bf5dcaae6d8e305e2283179ffba64bde9ed29e/LICENSE).