Re-branding; part 1 (#12076)

* Re-branding; part 1

* Update source/_docs/configuration/troubleshooting.markdown

Co-Authored-By: Paulus Schoutsen <balloob@gmail.com>

* Update source/_docs/configuration/yaml.markdown

Co-Authored-By: Paulus Schoutsen <balloob@gmail.com>

* Process review suggestions

* Remove Porosity page

* Update source/_docs/z-wave/installation.markdown

Co-Authored-By: Paulus Schoutsen <balloob@gmail.com>

* Process review suggestions

Co-authored-by: Paulus Schoutsen <paulus@home-assistant.io>
This commit is contained in:
Franck Nijhof 2020-02-13 19:39:47 +01:00 committed by GitHub
parent a5b66a324f
commit fb08878719
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
62 changed files with 265 additions and 466 deletions

View File

@ -287,7 +287,9 @@
["end ?to ?end", "end-to-end"], ["end ?to ?end", "end-to-end"],
["FRITZ!? ?Box", "FRITZ!Box"], ["FRITZ!? ?Box", "FRITZ!Box"],
["grey", "gray"], ["grey", "gray"],
["Hass\\.?io", "Home Assistant"],
["hass", "Home Assistant"], ["hass", "Home Assistant"],
["HassOS", "Home Assistant Operating System"],
["he or she", "they"], ["he or she", "they"],
["he/she", "they"], ["he/she", "they"],
["Home-?Ass?s?iss?tt?ant", "Home Assistant"], ["Home-?Ass?s?iss?tt?ant", "Home Assistant"],

View File

@ -15,9 +15,8 @@ If you are starting Home Assistant for the first time, or you have logged out, y
When you start Home Assistant for the first time the _owner_ user account is created. This account has some special privileges and can: When you start Home Assistant for the first time the _owner_ user account is created. This account has some special privileges and can:
- Create and manage other user accounts. - Create and manage other user accounts.
- Configure integrations and other settings (coming soon). - Configure integrations and other settings (coming soon).
- Configure Hass.io (coming soon).
<div class='note'> <div class='note'>
For the moment, other user accounts will have the same access as the owner account. In the future, non-owner accounts will be able to have restrictions applied. For the moment, other user accounts will have the same access as the owner account. In the future, non-owner accounts will be able to have restrictions applied.
@ -78,11 +77,11 @@ INFO (MainThread) [homeassistant.components.http.auth] You need to use a bearer
While you should hopefully be storing your passwords in a password manager, if you lose the password associated with the owner account the only way to resolve this is to delete *all* the authentication data. You do this by shutting down Home Assistant and deleting the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/): While you should hopefully be storing your passwords in a password manager, if you lose the password associated with the owner account the only way to resolve this is to delete *all* the authentication data. You do this by shutting down Home Assistant and deleting the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/):
* `auth` - `auth`
* `auth_provider.homeassistant` - `auth_provider.homeassistant`
* `onboarding` - `onboarding`
* `hassio` (for Hass.io users) - `hassio`
* `cloud` (for nabucasa users) - `cloud`
When you start Home Assistant next, you'll be required to set up authentication again. When you start Home Assistant next, you'll be required to set up authentication again.

View File

@ -9,13 +9,13 @@ The web interface can be found at `http://ip.ad.dre.ss:8123/` - for example if y
The location of the folder differs between operating systems: The location of the folder differs between operating systems:
| OS | Path | | OS | Path |
| ------- | -------------------------- | | -------------- | -------------------------- |
| macOS | `~/.homeassistant` | | Home Assistant | `/config` |
| Linux | `~/.homeassistant` | | Docker | `/config` |
| Windows | `%APPDATA%/.homeassistant` | | macOS | `~/.homeassistant` |
| Hass.io | `/config` | | Linux | `~/.homeassistant` |
| Docker | `/config` | | Windows | `%APPDATA%/.homeassistant` |
If you want to use a different folder for configuration, use the configuration command line parameter: `hass --config path/to/config`. If you want to use a different folder for configuration, use the configuration command line parameter: `hass --config path/to/config`.

View File

@ -20,8 +20,8 @@ If you have incorrect entries in your configuration files you can use the [`chec
One of the most common problems with Home Assistant is an invalid `configuration.yaml` or other configuration file. One of the most common problems with Home Assistant is an invalid `configuration.yaml` or other configuration file.
- You can test your configuration using the command line with: `hass --script check_config`. - With Home Assistant you can use the [`ha` command](/hassio/commandline/#home-assistant): `ha core check`.
- On Hass.io you can use the [`hassio` command](/hassio/commandline/#home-assistant): `hassio homeassistant check`. - You can test your configuration with Home Assistant Core using the command line with: `hass --script check_config`.
- On Docker you can use `docker exec home-assistant python -m homeassistant --script check_config --config /config` - where `home-assistant` is the name of the container. - On Docker you can use `docker exec home-assistant python -m homeassistant --script check_config --config /config` - where `home-assistant` is the name of the container.
- The configuration files, including `configuration.yaml` must be UTF-8 encoded. If you see error like `'utf-8' codec can't decode byte`, edit the offending configuration and re-save it as UTF-8. - The configuration files, including `configuration.yaml` must be UTF-8 encoded. If you see error like `'utf-8' codec can't decode byte`, edit the offending configuration and re-save it as UTF-8.
- You can verify your configuration's YAML structure using [this online YAML parser](http://yaml-online-parser.appspot.com/) or [YAML Lint](http://www.yamllint.com/). - You can verify your configuration's YAML structure using [this online YAML parser](http://yaml-online-parser.appspot.com/) or [YAML Lint](http://www.yamllint.com/).

View File

@ -66,7 +66,9 @@ sensor:
### Environmental variables ### Environmental variables
You can include values from your system's environment variables with `!env_var`. Note that this will only work in a scenario where it is possible to specify these. Hass.io users are recommended to use `!include` statements instead. On Home Assistant Core installations, you can include values from your system's environment variables with `!env_var`.
Note that this will only work for Home Assistant Core installations, in a scenario where it is possible to specify these.
Regular Home Assistant users are recommended to use `!include` statements instead.
```yaml ```yaml
example: example:

View File

@ -5,7 +5,8 @@ description: "A guide to remotely accessing Home Assistant and securing the conn
<div class='note'> <div class='note'>
If you are using Hass.io do not use this guide. Instead, use the [DuckDNS add-on](/addons/duckdns/) for Hass.io. This guide is for users running Home Assistant Core.
If you are using Home Assistant do not use this guide. Instead, use the [DuckDNS add-on](/addons/duckdns/) for Home Assistant.
</div> </div>

View File

@ -26,11 +26,11 @@ The certificate **must** be `.pem` extension.
openssl req -sha256 -newkey rsa:4096 -nodes -keyout privkey.pem -x509 -days 730 -out fullchain.pem openssl req -sha256 -newkey rsa:4096 -nodes -keyout privkey.pem -x509 -days 730 -out fullchain.pem
``` ```
For details about the parameters, please check the OpenSSL documentation. Provide the requested information during the generation process. For details about the parameters, please check the OpenSSL documentation. Provide the requested information during the generation process.
At the end you will have two files called `privkey.pem` and `fullchain.pem`. The key and the certificate. At the end you will have two files called `privkey.pem` and `fullchain.pem`. The key and the certificate.
Update the `http:` entry in your `configuration.yaml` file and let it point to your created files. Update the `http:` entry in your `configuration.yaml` file and let it point to your created files.
Hass.io: Hass.io:
@ -52,7 +52,7 @@ A restart of Home Assistant is required for the new certificate to take effect.
If you get any log error about *ssl_key* or *ssl_certificate* that is **not a file for dictionary value** when run Home Assistant, you need to change owner or access permission of the `.pem` files as following: If you get any log error about *ssl_key* or *ssl_certificate* that is **not a file for dictionary value** when run Home Assistant, you need to change owner or access permission of the `.pem` files as following:
Hass.io (through Console or SSH plug-in): Home Assistant (through console or SSH add-on):
```bash ```bash
chown root:root fullchain.pem privkey.pem chown root:root fullchain.pem privkey.pem

View File

@ -47,13 +47,13 @@ These install options are fully supported by Home Assistant's documentation. For
<div class='note'> <div class='note'>
The only installation methods that allow you to use Hass.io Add-ons are the Hass.io image and [manual installer](/hassio/installation/#alternative-install-on-a-generic-linux-host). All other methods only install the base Home Assistant packages, however the software from the add-ons may still usually be installed manually like any other program. The only installation methods that allow you to use Home Assistant Add-ons is using the Home Assistant image and [manual Supervised installer](/hassio/installation/#alternative-install-on-a-generic-linux-host). All other methods only install the base Home Assistant packages, however the software from the add-ons may still usually be installed manually like any other program.
</div> </div>
**Method**|**You have**|**Recommended for** **Method**|**You have**|**Recommended for**
:-----|:-----|:----- :-----|:-----|:-----
[Hass.io](/hassio/installation/)|Raspberry Pi<br>VM|Anybody [Home Assistant](/hassio/installation/)|Raspberry Pi<br>VM|Anybody
[Docker](/docs/installation/docker/)|Docker|Anybody already running Docker [Docker](/docs/installation/docker/)|Docker|Anybody already running Docker
## Alternative installs ## Alternative installs
@ -116,6 +116,6 @@ These guides are provided as-is. Some of these install methods are more limited
<div class='img-container'> <div class='img-container'>
<img src='/images/supported_brands/home-assistant.png' /> <img src='/images/supported_brands/home-assistant.png' />
</div> </div>
<div class='title'>Hass.io <br> on generic Linux server</div> <div class='title'>Home Assistant Supervised <br> on generic Linux server</div>
</a> </a>
</div> </div>

View File

@ -11,13 +11,13 @@ Synology only provide Python 3.5.1, which is not compatible with Home Assistant
</div> </div>
There are 3 alternatives, when using Home Assistant on Synology NAS: There are 3 alternatives, when using Home Assistant on Synology NAS:
1. using Docker 1. Using Home Assistant Core on Docker
2. directly running on DSM 2. Directly running Home Assistant Core on DSM
3. using Hass.io in a VM (if you have an Intel based Synology) 3. Using the Home Assistant a VM (if you have an Intel based Synology)
Option 1 is described on the [Docker installation page](/docs/installation/docker/). Option 1 is described on the [Docker installation page](/docs/installation/docker/).
Option 3 uses the Synology Based Virtual Machine Manager. You can import the VDI image to be found at the [Hass.io installation page](/hassio/installation/). Download the image and add it to the image store. The go to "Virtual Machine" in the interface and create a new VM with the image you just added. Option 3 uses the Synology Based Virtual Machine Manager. You can import the VDI image to be found at the [Home Assistant installation page](/hassio/installation/). Download the image and add it to the image store. The go to "Virtual Machine" in the interface and create a new VM with the image you just added.
The main benefit from this method is that you can assign Home Assistant its own IP number, so there is no risk regarding TCP/UDP port conflicts. USB dongles an be connected to the VM without the need to install a driver in DSM. The main benefit from this method is that you can assign Home Assistant its own IP number, so there is no risk regarding TCP/UDP port conflicts. USB dongles an be connected to the VM without the need to install a driver in DSM.

View File

@ -6,7 +6,7 @@ redirect_from: /getting-started/updating/
<div class='note warning'> <div class='note warning'>
The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/) or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant). The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Home Assistant](/hassio/) or [Home Assistant Core](/docs/installation/virtualenv/#upgrading-home-assistant).
</div> </div>
@ -14,29 +14,28 @@ Check what's new in the latest version and potentially impacts your system in [H
<div class='note'> <div class='note'>
To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/) or [Virtualenv](/docs/installation/virtualenv). To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Home Assistant](/hassio/) or [Home Assistant Core](/docs/installation/virtualenv).
</div> </div>
The default way to update Home Assistant to the latest release, when available, is: The default way to update Home Assistant to the latest release, when available, is:
```bash ```bash
$ pip3 install --upgrade homeassistant pip3 install --upgrade homeassistant
``` ```
For a Docker container, simply pull the latest one: For a Docker container, simply pull the latest one:
```bash ```bash
$ sudo docker pull homeassistant/home-assistant:latest sudo docker pull homeassistant/home-assistant:latest
``` ```
For a Raspberry Pi Docker container, simply pull the latest one: For a Raspberry Pi Docker container, simply pull the latest one:
```bash ```bash
$ sudo docker pull homeassistant/raspberrypi3-homeassistant:latest sudo docker pull homeassistant/raspberrypi3-homeassistant:latest
``` ```
After updating, you must start/restart Home Assistant for the changes to take effect. This means that you will have to restart `hass` itself or the [autostarting](/docs/autostart/) daemon (if applicable). Startup can take considerable amount of time (i.e. minutes) depending on your device. This is because all requirements are updated as well. After updating, you must start/restart Home Assistant for the changes to take effect. This means that you will have to restart `hass` itself or the [autostarting](/docs/autostart/) daemon (if applicable). Startup can take considerable amount of time (i.e. minutes) depending on your device. This is because all requirements are updated as well.
[BRUH automation](https://www.bruhautomation.io/) has created [a tutorial video](https://www.youtube.com/watch?v=tuG2rs1Cl2Y) explaining how to upgrade Home Assistant. [BRUH automation](https://www.bruhautomation.io/) has created [a tutorial video](https://www.youtube.com/watch?v=tuG2rs1Cl2Y) explaining how to upgrade Home Assistant.
@ -46,7 +45,7 @@ After updating, you must start/restart Home Assistant for the changes to take ef
In the event that a Home Assistant version doesn't play well with your hardware setup, you can downgrade to a previous release: In the event that a Home Assistant version doesn't play well with your hardware setup, you can downgrade to a previous release:
```bash ```bash
$ pip3 install homeassistant==0.XX.X pip3 install homeassistant==0.XX.X
``` ```
#### Run the beta version #### Run the beta version
@ -54,7 +53,7 @@ $ pip3 install homeassistant==0.XX.X
If you would like to test next release before anyone else, you can install the beta version released every two weeks: If you would like to test next release before anyone else, you can install the beta version released every two weeks:
```bash ```bash
$ pip3 install --pre --upgrade homeassistant pip3 install --pre --upgrade homeassistant
``` ```
#### Run the development version #### Run the development version
@ -69,11 +68,11 @@ If you want to stay on the bleeding-edge Home Assistant development branch, you
$ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev $ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev
``` ```
### Update Hass.io installation ### Update Home Assistant installation
Best practice for updating a Hass.io installation: Best practice for updating a Home Assistant installation:
1. Backup your installation, using the snapshot functionality Hass.io offers. 1. Backup your installation, using the snapshot functionality Home Assistant offers.
2. Check the release notes for breaking changes on [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f`) and search for **Breaking Changes**. 2. Check the release notes for breaking changes on [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f`) and search for **Breaking Changes**.
3. Check your configuration using the [Check Home Assistant configuration](/addons/check_config/) add-on. 3. Check your configuration using the [Check Home Assistant configuration](/addons/check_config/) add-on.
4. If the check passes, you can safely update. If not, update your configuration accordingly. 4. If the check passes, you can safely update. If not, update your configuration accordingly.

View File

@ -1,15 +1,18 @@
--- ---
title: "MQTT Brokers" title: "MQTT Broker"
description: "Instructions on how to setup MQTT brokers for Home Assistant." description: "Instructions on how to setup a MQTT broker for Home Assistant."
logo: mqtt.png logo: mqtt.png
--- ---
The MQTT integration needs you to run an MQTT broker for Home Assistant to connect to. There are four options, each with various degrees of ease of setup and privacy. The MQTT integration needs you to run an MQTT broker for Home Assistant to connect to.
### Run your own ### Run your own
This is the most private option, but it requires a little bit of work to setup. There are multiple free and open-source brokers to pick from: e.g., [Mosquitto](http://mosquitto.org/), [EMQ](https://github.com/emqx/emqx) or [Mosca](http://www.mosca.io/). This is the most private option, is running your own MQTT broker.
For Hass.io users, the recommended setup method is to use the [Mosquitto MQTT broker addon](/addons/mosquitto).
The recommended setup method is to use the [Mosquitto MQTT broker addon](/addons/mosquitto).
## Configuration
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
@ -48,7 +51,7 @@ protocol:
type: string type: string
certificate: certificate:
required: false required: false
description: Path to the certificate file, e.g., `/home/user/.homeassistant/server.crt`. description: Path to the certificate file, e.g., `/ssl/server.crt`.
type: string type: string
tls_insecure: tls_insecure:
required: false required: false
@ -61,26 +64,6 @@ tls_version:
type: string type: string
{% endconfiguration %} {% endconfiguration %}
<div class='note warning'>
There is an issue with the Mosquitto package included in Ubuntu 14.04 LTS. Specify `protocol: 3.1` in your MQTT configuration to work around this issue.
If you get this error `AttributeError: module 'ssl' has no attribute 'PROTOCOL_TLS'` then you need to set `tls_version: '1.2'`.
</div>
<div class='note'>
If you are running a Mosquitto instance on the same server as Home Assistant then you must ensure that the Mosquitto service starts before Home Assistant. For a Linux instance running Systemd (Raspberry Pi, Debian, Ubuntu and others) then you should edit the file `/etc/systemd/system/home-assistant@homeassistant.service` as `root` (e.g., `sudo nano /etc/systemd/system/home-assistant@homeassistant.service`) and add the Mosquitto service:
```txt
[Unit]
Description=Home Assistant
After=network.target mosquitto.service
```
</div>
<div class='note'> <div class='note'>
If you are running a Mosquitto instance on a different server with proper SSL encryption using a service like Let's Encrypt you may have to set the certificate to the operating systems own `.crt` certificates file. In the instance of Ubuntu this would be `certificate: /etc/ssl/certs/ca-certificates.crt` If you are running a Mosquitto instance on a different server with proper SSL encryption using a service like Let's Encrypt you may have to set the certificate to the operating systems own `.crt` certificates file. In the instance of Ubuntu this would be `certificate: /etc/ssl/certs/ca-certificates.crt`
@ -161,10 +144,6 @@ mqtt:
As of release 0.92, the embedded broker has been marked as deprecated. This means bugs may not be fixed, and the functionality may be removed in a future release. As of release 0.92, the embedded broker has been marked as deprecated. This means bugs may not be fixed, and the functionality may be removed in a future release.
</div> </div>
<div class='note'>
Before release 0.76, the embedded broker would use your API password as a password to the MQTT user. This is no longer the case.
</div>
<div class='note warning'> <div class='note warning'>
There is [an issue](https://github.com/beerfactory/hbmqtt/issues/62) with the HBMQTT broker and the WebSocket connection that is causing a memory leak. If you experience this issue, consider using another broker like Mosquitto. There is [an issue](https://github.com/beerfactory/hbmqtt/issues/62) with the HBMQTT broker and the WebSocket connection that is causing a memory leak. If you experience this issue, consider using another broker like Mosquitto.

View File

@ -7,7 +7,7 @@ As Home Assistant is like every other service or daemon that is running on a com
[Secure your installation](/docs/configuration/securing/) once you've finished with the installation process regardless of your use case. [Secure your installation](/docs/configuration/securing/) once you've finished with the installation process regardless of your use case.
Home Assistant is NOT able to change the configuration of your router or firewall. This means that you need to setup [port-forwarding](/docs/configuration/remote/) and adjusting firewall rules if you want to allow access from the internet. By default your frontend and your Hass.io add-ons like Mosquitto, SSH and your Samba shares are only accessible from your local network. Home Assistant is NOT able to change the configuration of your router or firewall. This means that you need to setup [port-forwarding](/docs/configuration/remote/) and adjusting firewall rules if you want to allow access from the internet. By default your frontend and your Home Assistant add-ons like Mosquitto, SSH and your Samba shares are only accessible from your local network.
## Server banner ## Server banner
@ -17,8 +17,6 @@ Further [details about the fingerprint/server banner](/docs/security/webserver/)
The default port of Home Assistant is 8123. This is the port where the [`frontend`](/integrations/frontend/) and the [`API`](/integrations/api/) is served. Both are depending on the [`http`](/integrations/http/) integration which contains the capability to adjust the settings like `server_host` or `server_port`. The default port of Home Assistant is 8123. This is the port where the [`frontend`](/integrations/frontend/) and the [`API`](/integrations/api/) is served. Both are depending on the [`http`](/integrations/http/) integration which contains the capability to adjust the settings like `server_host` or `server_port`.
See the [open ports](/docs/security/porosity/) of a Hass.io instance with various add-ons.
## HTTP SSL/TLS ## HTTP SSL/TLS
Home Assistant is following the [Mozilla's Operations Security team recommendations](https://wiki.mozilla.org/Security/Server_Side_TLS) for Server side SSL/TLS settings. Home Assistant uses **Modern compatibility** by default. If an user wishes to use **Intermediate compatibility**, this is configurable in the [`http` integration](/integrations/http/). Home Assistant is following the [Mozilla's Operations Security team recommendations](https://wiki.mozilla.org/Security/Server_Side_TLS) for Server side SSL/TLS settings. Home Assistant uses **Modern compatibility** by default. If an user wishes to use **Intermediate compatibility**, this is configurable in the [`http` integration](/integrations/http/).
@ -27,7 +25,7 @@ Home Assistant is following the [Mozilla's Operations Security team recommendati
The SSH connection for [debugging](https://developers.home-assistant.io/docs/en/hassio_debugging.html) on port 22222 is not enabled by default and can only be used with keys. The SSH connection for [debugging](https://developers.home-assistant.io/docs/en/hassio_debugging.html) on port 22222 is not enabled by default and can only be used with keys.
If SSH is used with the [SSH server add-on](/addons/ssh/) then the user is responsible for the configuration and security. If SSH is used with the [SSH server add-on](/addons/ssh/) then the user is responsible for the configuration and security.
## Source code ## Source code

View File

@ -1,189 +0,0 @@
---
title: "Home Assistant/Hass.io porosity"
description: "Use nmap to scan your Home Assistant instance."
---
As a large amount of users are running [Hass.io](/hassio/), here we are using a Raspberry Pi 3 B and Hass.io 0.70.0 to show how Home Assistant looks from the network side. This is not a full blown investigation, just a quick overview.
The IP address of the Home Assistant machine is 192.168.0.215. The system which is the source of the scans is a machine running Fedora 27 and Nmap 7.60 is used to perform the port scans. Both systems are in the same network.
## SSH server Add-on
To get access to Hass.io in secure way, SSH is provided by the [SSH server add-on](/addons/ssh/).
```bash
$ sudo nmap -A -n --reason -Pn -T5 -p1-65535 192.168.0.215
Starting Nmap 7.60 ( https://nmap.org ) at 2018-05-29 15:08 CEST
Nmap scan report for 192.168.0.215
Host is up, received arp-response (0.00051s latency).
Not shown: 65532 closed ports
Reason: 65532 resets
PORT STATE SERVICE REASON VERSION
22/tcp open ssh syn-ack ttl 63 OpenSSH 7.5 (protocol 2.0)
| ssh-hostkey:
| 2048 e3:a2:2d:20:3a:67:68:b9:b1:9e:16:fa:48:80:82:96 (RSA)
| 256 92:f0:f4:be:4f:44:60:0e:c4:92:8a:cb:34:9e:c5:c2 (ECDSA)
|_ 256 09:da:a2:14:cd:c4:69:e9:13:e6:70:64:98:d0:55:0c (EdDSA)
8123/tcp open http syn-ack ttl 64 aiohttp 3.1.3 (Python 3.6)
|_http-open-proxy: Proxy might be redirecting requests
| http-robots.txt: 1 disallowed entry
|_/
|_http-server-header: Python/3.6 aiohttp/3.1.3
|_http-title: Home Assistant
22222/tcp open ssh syn-ack ttl 64 Dropbear sshd 2016.74 (protocol 2.0)
MAC Address: B8:41:CD:4B:7A:5D (Raspberry Pi Foundation)
Device type: general purpose
Running: Linux 3.X|4.X
OS CPE: cpe:/o:linux:linux_kernel:3 cpe:/o:linux:linux_kernel:4
OS details: Linux 3.2 - 4.8
Network Distance: 1 hop
Service Info: OS: Linux; CPE: cpe:/o:linux:linux_kernel
TRACEROUTE
HOP RTT ADDRESS
1 0.51 ms 192.168.0.215
OS and Service detection performed. Please report any incorrect results at https://nmap.org/submit/ .
Nmap done: 1 IP address (1 host up) scanned in 726.23 seconds
```
That port 22 and 8123 are open was expected. On port 22222 is an additional SSH server running. This port is for [debugging](https://developers.home-assistant.io/docs/en/hassio_debugging.html) and supports only a login with a key. This means that you would need to remove the SD card from your Raspberry Pi, create an `authorized_keys` with your SSH public key in it and put the SD Card back in your Pi to get access.
## Mosquitto MQTT broker Add-on
While setting up the [Mosquitto MQTT broker add-on](/addons/mosquitto/) no settings were modified, the add-on was running with the default settings.
```bash
$ sudo nmap -A -n --reason -Pn -T5 -p1-65535 192.168.0.215
Starting Nmap 7.60 ( https://nmap.org ) at 2018-05-29 15:52 CEST
Nmap scan report for 192.168.0.215
Host is up, received arp-response (0.0011s latency).
Not shown: 65532 closed ports
Reason: 65532 resets
PORT STATE SERVICE REASON VERSION
1883/tcp open mosquitto version 1.4.12 syn-ack ttl 63
| mqtt-subscribe:
| Topics and their most recent payloads:
| $SYS/broker/load/connections/5min: 0.39
[...]
| $SYS/broker/load/connections/15min: 0.13
|_ $SYS/broker/clients/total: 2
8123/tcp open http syn-ack ttl 64 aiohttp 3.1.3 (Python 3.6)
|_http-open-proxy: Proxy might be redirecting requests
| http-robots.txt: 1 disallowed entry
|_/
|_http-server-header: Python/3.6 aiohttp/3.1.3
|_http-title: Home Assistant
22222/tcp open ssh syn-ack ttl 64 Dropbear sshd 2016.74 (protocol 2.0)
MAC Address: B8:41:CD:4B:7A:5D (Raspberry Pi Foundation)
Device type: general purpose
Running: Linux 3.X|4.X
OS CPE: cpe:/o:linux:linux_kernel:3 cpe:/o:linux:linux_kernel:4
OS details: Linux 3.2 - 4.8
Network Distance: 1 hop
Service Info: OS: Linux; CPE: cpe:/o:linux:linux_kernel
TRACEROUTE
HOP RTT ADDRESS
1 1.13 ms 192.168.0.215
OS and Service detection performed. Please report any incorrect results at https://nmap.org/submit/ .
Nmap done: 1 IP address (1 host up) scanned in 223.76 seconds
```
To secure MQTT to consider to use certificates and to specify users with password under `logins:` at least. Use port 1883 only in your local network.
## Samba Add-on
The [Samba add-on](/addons/samba/) enables one to use a Windows system to access the configuration and other shares. Per default there is no user set. To increase your local security we strongly suggest that you set a username and a password and don't allow guests. A sample configuration could look like the one below.
A port scan for Hass.io with this add-on will give you the details.
```bash
$ sudo nmap -A -n --reason -Pn -T5 -p1-65535 192.168.0.215
Starting Nmap 7.60 ( https://nmap.org ) at 2018-05-29 16:29 CEST
Host is up, received arp-response (0.00045s latency).
Not shown: 65523 closed ports
Reason: 65523 resets
PORT STATE SERVICE REASON VERSION
139/tcp open netbios-ssn syn-ack ttl 64 Samba smbd 3.X - 4.X (workgroup: WORKGROUP)
445/tcp open netbios-ssn syn-ack ttl 64 Samba smbd 4.7.3 (workgroup: WORKGROUP)
8123/tcp open http syn-ack ttl 64 aiohttp 3.1.3 (Python 3.6)
|_http-open-proxy: Proxy might be redirecting requests
| http-robots.txt: 1 disallowed entry
|_/
|_http-server-header: Python/3.6 aiohttp/3.1.3
|_http-title: Home Assistant
22222/tcp open ssh syn-ack ttl 64 Dropbear sshd 2016.74 (protocol 2.0)
MAC Address: B8:41:CD:4B:7A:5D (Raspberry Pi Foundation)
Device type: general purpose
Running: Linux 3.X|4.X
OS CPE: cpe:/o:linux:linux_kernel:3 cpe:/o:linux:linux_kernel:4
OS details: Linux 3.2 - 4.8
Network Distance: 1 hop
Service Info: Host: HASSIO; OS: Linux; CPE: cpe:/o:linux:linux_kernel
Host script results:
|_nbstat: NetBIOS name: HASSIO, NetBIOS user: <unknown>, NetBIOS MAC: <unknown> (unknown)
| smb-os-discovery:
| OS: Windows 6.1 (Samba 4.7.3)
| Computer name: \x00
| NetBIOS computer name: HASSIO\x00
| Workgroup: WORKGROUP\x00
|_ System time: 2018-05-29T16:41:05+02:00
| smb-security-mode:
| account_used: guest
| authentication_level: user
| challenge_response: supported
|_ message_signing: disabled (dangerous, but default)
| smb2-security-mode:
| 2.02:
|_ Message signing enabled but not required
| smb2-time:
| date: 2018-05-29 16:41:05
|_ start_date: 1601-01-01 00:53:28
TRACEROUTE
HOP RTT ADDRESS
1 0.46 ms 192.168.0.215
OS and Service detection performed. Please report any incorrect results at https://nmap.org/submit/ .
Nmap done: 1 IP address (1 host up) scanned in 727.43 seconds
```
139 and 445 are open and it's possible to enumerate the shares. With different tools you will get pretty much the same information.
```bash
$ smbclient -L //192.168.0.215 -U%
Sharename Type Comment
--------- ---- -------
config Disk
addons Disk
share Disk
backup Disk
IPC$ IPC
IPC Service (Samba Home Assistant config share)
Reconnecting with SMB1 for workgroup listing.
Server Comment
--------- -------
Workgroup Master
--------- -------
WORKGROUP HASSIO
```
But without username and password you can't get access to the configuration file with the settings shown here.
```json
[...]
"guest": false,
"username": "homeassistant",
"password": "homeassistant",
"interface": "eth0"
}
```

View File

@ -105,25 +105,25 @@ Ensure you keep a backup of this key. If you have to rebuild your system and don
## First Run ## First Run
On platforms other than Hass.io and Docker, the compilation and installation of python-openzwave happens when you first enable the Z-Wave component, and can take half an hour or more on a Raspberry Pi. When you upgrade Home Assistant and python-openzwave is also upgraded, this will also result in a delay while the new version is compiled and installed. On platforms other than Home Assistant and Docker, the compilation and installation of python-openzwave happens when you first enable the Z-Wave component, and can take half an hour or more on a Raspberry Pi. When you upgrade Home Assistant and python-openzwave is also upgraded, this will also result in a delay while the new version is compiled and installed.
The first run after adding a device is when the `zwave` integration will take time to initialize the entities, some entities may appear with incomplete names. Running a network heal may speed up this process. The first run after adding a device is when the `zwave` integration will take time to initialize the entities, some entities may appear with incomplete names. Running a network heal may speed up this process.
## Platform specific instructions ## Platform specific instructions
### Hass.io ### Home Assistant
You do not need to install any software to use Z-Wave. You do not need to install any software to use Z-Wave.
If the path of `/dev/ttyACM0` doesn't work, look in the *System* section of the *Supervisor* menu. There you'll find a *Hardware* button which will list all the hardware found. If the path of `/dev/ttyACM0` doesn't work, look in the *System* section of the *Supervisor* menu. There you'll find a *Hardware* button which will list all the hardware found.
You can also check what hardware has been found using the [`hassio` command](/hassio/commandline/#hardware): You can also check what hardware has been found using the [`ha` command](/hassio/commandline/#hardware):
```bash ```bash
hassio hardware info ha hardware info
``` ```
If you did an alternative install of Hass.io on Linux (e.g. installing Ubuntu, then Docker, then Hass.io) then the `modemmanager` package will interfere with any Z-Wave (or Zigbee) stick and should be removed or disabled in the host OS. Failure to do so will result in random failures of those components, e.g. dead or unreachable Z-Wave nodes, most notably right after Home Assistant restarts. Connect to your host OS via SSH, then you can disable with `sudo systemctl disable ModemManager` and remove with `sudo apt-get purge modemmanager` (commands are for Debian/Ubuntu). If you did an alternative install of Home Assistant on Linux (e.g. installing Ubuntu, then Docker, then Home Assistant Supervised) then the `modemmanager` package will interfere with any Z-Wave (or Zigbee) stick and should be removed or disabled in the host OS. Failure to do so will result in random failures of those components, e.g. dead or unreachable Z-Wave nodes, most notably right after Home Assistant restarts. Connect to your host OS via SSH, then you can disable with `sudo systemctl disable ModemManager` and remove with `sudo apt-get purge modemmanager` (commands are for Debian/Ubuntu).
### Docker ### Docker
@ -149,7 +149,7 @@ The `modemmanager` package will interfere with any Z-Wave (or Zigbee) stick and
On the Raspberry Pi you will need to enable the serial interface in the `raspi-config` tool before you can add Z-Wave to Home Assistant. Make sure to reboot the Raspberry Pi for the setting to take effect. On the Raspberry Pi you will need to enable the serial interface in the `raspi-config` tool before you can add Z-Wave to Home Assistant. Make sure to reboot the Raspberry Pi for the setting to take effect.
#### Linux #### Linux with Home Assistant Core
On Debian Linux platforms there are dependencies you will need to have installed ahead of time (included in `systemd-devel` on Fedora/RHEL systems): On Debian Linux platforms there are dependencies you will need to have installed ahead of time (included in `systemd-devel` on Fedora/RHEL systems):

View File

@ -1,11 +1,13 @@
--- ---
title: "Home Assistant vs. Hass.io" title: "Home Assistant vs. Home Assistant Core"
description: "Home Assistant vs. Hass.io" description: "Home Assistant vs. Home Assistant Core"
ha_category: Installation ha_category: Installation
--- ---
Home Assistant is a Python program, in simple words. It can be run on various operating systems and provide the ability to track, control and automate your devices. When people talking about Home Assistant they usually refer to a standalone [installation method](/docs/installation/). Home Assistant Core is a Python program, in simple words. It can be run on various operating systems and provide the ability to track, control and automate your devices.
When people talking about Home Assistant Core they usually refer to a standalone [installation method](/docs/installation/).
[Hass.io](/hassio/) is a combination of Home Assistant and tools which allows one to run it easily on a Raspberry Pi and other platforms without setting up an operating system first. Hass.io is an all-in one-solution and has a management user interface that can be used from the Home Assistant frontend. This interface is not present in a standalone setup of Home Assistant. [Home Assistant](/hassio/) is a combination of Home Assistant Core and tools which allows one to run it easily on a Raspberry Pi and other platforms without setting up an operating system first.
Home Assistant is an all-in one-solution and has a management user interface that can be used from the Home Assistant frontend. This interface is not present in a Home Assistant Core setup.
Be aware that add-ons are only available in Hass.io, due to the way Hass.io is installed. Be aware that add-ons are only available in regular Home Assistant installations.

View File

@ -148,7 +148,6 @@
<li> <li>
{% active_link /docs/security/webserver/ Web server fingerprint %} {% active_link /docs/security/webserver/ Web server fingerprint %}
</li> </li>
<li>{% active_link /docs/security/porosity/ Porosity %}</li>
</ul> </ul>
</li> </li>
<li> <li>

View File

@ -19,7 +19,7 @@ The built-in Alexa integration allows you to integrate Home Assistant into Alexa
- Amazon Developer Account. You can sign on [here](https://developer.amazon.com). - Amazon Developer Account. You can sign on [here](https://developer.amazon.com).
- An [AWS account](https://aws.amazon.com/free/) is need if you want to use Alexa Custom Skill API. Part of your Alexa Custom Skill will be hosted on [AWS Lambda](https://aws.amazon.com/lambda/pricing/). However you don't need worry the cost, AWS Lambda allow free to use up to 1 millions requests and 1GB outbound data transfer per month. - An [AWS account](https://aws.amazon.com/free/) is need if you want to use Alexa Custom Skill API. Part of your Alexa Custom Skill will be hosted on [AWS Lambda](https://aws.amazon.com/lambda/pricing/). However you don't need worry the cost, AWS Lambda allow free to use up to 1 millions requests and 1GB outbound data transfer per month.
- The Alexa Custom Skill API also needs your Home Assistant instance to be accessible from the internet via HTTPS on port 443 using a certificate signed by [an Amazon approved certificate authority](https://ccadb-public.secure.force.com/mozilla/IncludedCACertificateReport), this is so account linking can take place. Read more on [our blog](/blog/2015/12/13/setup-encryption-using-lets-encrypt/) about how to set up encryption for Home Assistant. When running Hass.io using the [Duck DNS](/addons/duckdns/) add-on is the easiest method. - The Alexa Custom Skill API also needs your Home Assistant instance to be accessible from the internet via HTTPS on port 443 using a certificate signed by [an Amazon approved certificate authority](https://ccadb-public.secure.force.com/mozilla/IncludedCACertificateReport), this is so account linking can take place. Read more on [our blog](/blog/2015/12/13/setup-encryption-using-lets-encrypt/) about how to set up encryption for Home Assistant. When running Home Assistant using the [Duck DNS](/addons/duckdns/) add-on is the easiest method.
### Create Your Amazon Alexa Custom Skill ### Create Your Amazon Alexa Custom Skill

View File

@ -47,7 +47,7 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant:
## Requirements ## Requirements
- The Alexa Smart Home API requires your Home Assistant instance to be accessible from the internet via HTTPS on port 443 using an SSL/TLS certificate. A self-signed certificate will work, but a certificate signed by [an Amazon approved certificate authority](https://ccadb-public.secure.force.com/mozilla/IncludedCACertificateReport) is recommended. Read more on [our blog](/blog/2015/12/13/setup-encryption-using-lets-encrypt/) about how to set up encryption for Home Assistant. When running Hass.io using the [Duck DNS](/addons/duckdns/) add-on is the easiest method. - The Alexa Smart Home API requires your Home Assistant instance to be accessible from the internet via HTTPS on port 443 using an SSL/TLS certificate. A self-signed certificate will work, but a certificate signed by [an Amazon approved certificate authority](https://ccadb-public.secure.force.com/mozilla/IncludedCACertificateReport) is recommended. Read more on [our blog](/blog/2015/12/13/setup-encryption-using-lets-encrypt/) about how to set up encryption for Home Assistant. When running Home Assistant using the [Duck DNS](/addons/duckdns/) add-on is the easiest method.
- Amazon Developer Account. Sign up [here](https://developer.amazon.com). - Amazon Developer Account. Sign up [here](https://developer.amazon.com).
- An [Amazon Web Services (AWS)](https://aws.amazon.com/free/) account is required to host the Lambda function for your Alexa Smart Home Skill. [AWS Lambda](https://aws.amazon.com/lambda/pricing/) is free to use for up to 1-million requests and 1GB outbound data transfer per month. - An [Amazon Web Services (AWS)](https://aws.amazon.com/free/) account is required to host the Lambda function for your Alexa Smart Home Skill. [AWS Lambda](https://aws.amazon.com/lambda/pricing/) is free to use for up to 1-million requests and 1GB outbound data transfer per month.

View File

@ -24,9 +24,9 @@ Almond consists of three parts:
## Installation ## Installation
### Hass.io installation ### Home Assistant add-on installation
To install Almond Server on Hass.io, go to Hass.io App Store, search for Almond and click on Install. Once started, it will initiate a configuration flow to finish set up in Home Assistant. You can find it on the integrations page in the configuration panel. To install Almond Server, go to the Home Assistant add-on store, search for Almond and click on Install. Once started, it will initiate a configuration flow to finish set up in Home Assistant. You can find it on the integrations page in the configuration panel.
### Manual installation ### Manual installation

View File

@ -180,7 +180,7 @@ Prior to Home Assistant 0.101, this approach did not work well for newer devices
The second option is to use an ADB server to connect to your Android TV and Fire TV devices. The second option is to use an ADB server to connect to your Android TV and Fire TV devices.
For Hass.io users, you can install the [Android Debug Bridge](https://github.com/hassio-addons/addon-adb/blob/master/README.md) addon. Using this approach, Home Assistant will send the ADB commands to the server, which will then send them to the Android TV / Fire TV device and report back to Home Assistant. To use this option, add the `adb_server_ip` option to your configuration. If you are running the server on the same machine as Home Assistant, you can use `127.0.0.1` for this value. For Home Assistant users, you can install the [Android Debug Bridge](https://github.com/hassio-addons/addon-adb/blob/master/README.md) addon. Using this approach, Home Assistant will send the ADB commands to the server, which will then send them to the Android TV / Fire TV device and report back to Home Assistant. To use this option, add the `adb_server_ip` option to your configuration. If you are running the server on the same machine as Home Assistant, you can use `127.0.0.1` for this value.
## ADB Troubleshooting ## ADB Troubleshooting

View File

@ -17,9 +17,9 @@ There is currently support for the following device types within Home Assistant:
- [Binary Sensor](#binary-sensor) - [Binary Sensor](#binary-sensor)
- [Sensor](#sensor) - [Sensor](#sensor)
## Hass.io Installation ## Home Assistant add-on installation
Install this [unofficial add-on](https://github.com/korylprince/hassio-apcupsd/) to use this integration with Hass.io. Keep in mind that we can't give you support for this add-on. Install this [unofficial add-on](https://github.com/korylprince/hassio-apcupsd/) to use this integration with Home Assistant. Keep in mind that we can't give you support for this add-on.
After installation, follow the instructions on the GitHub page to configure the plugin. Then continue to follow the integration configurations below. After installation, follow the instructions on the GitHub page to configure the plugin. Then continue to follow the integration configurations below.
@ -47,7 +47,7 @@ port:
<div class='note'> <div class='note'>
If you get `ConnectionRefusedError: Connection refused` errors in the Home Assistant logs, ensure the [Apcupsd](http://www.apcupsd.org/) configuration directives used by its Network Information Server is set to permit connections from all addresses [NISIP 0.0.0.0](http://www.apcupsd.org/manual/manual.html#configuration-directives-used-by-the-network-information-server), else non-local addesses will not connect. This includes Hass.io running in Docker, even when hosted on the same machine or a virtual machine. If you get `ConnectionRefusedError: Connection refused` errors in the Home Assistant logs, ensure the [Apcupsd](http://www.apcupsd.org/) configuration directives used by its Network Information Server is set to permit connections from all addresses [NISIP 0.0.0.0](http://www.apcupsd.org/manual/manual.html#configuration-directives-used-by-the-network-information-server), else non-local addresses will not connect.
</div> </div>

View File

@ -16,9 +16,9 @@ The `beewi_smartclim` sensor platform allows one to monitor room or external tem
Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system: Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system:
- On [Hass.io](/hassio/installation/): `beewi_smartclim` will work out of the box as long as the host supports Bluetooth (like the Raspberry Pi does). - `beewi_smartclim` will work out of the box as long as the host supports Bluetooth (like the Raspberry Pi does).
- On a [generic Docker installation](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host. - Using [Home Assistant Core on Docker installation](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host.
- On other Linux systems: - On other Home Assistant Core systems:
- Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one. - Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one.
- Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth` or `bluez-deprecated`. - Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth` or `bluez-deprecated`.
- Windows and macOS are currently not supported by the `btlewrap` library. - Windows and macOS are currently not supported by the `btlewrap` library.

View File

@ -180,9 +180,9 @@ group:
- sensor.bme680_sensor_air_quality - sensor.bme680_sensor_air_quality
``` ```
## Directions for enabling I2C interface on Hass.io ## Directions for enabling I2C interface on the Home Assistant Operating System
Follow the instructions here to [enable I2C on Hass.io.](/hassio/enable_i2c/). Follow the instructions here to [enable I2C here.](/hassio/enable_i2c/).
## Directions for installing SMBus support on Raspberry Pi ## Directions for installing SMBus support on Raspberry Pi
@ -190,7 +190,7 @@ Enable I2C interface with the Raspberry Pi configuration utility:
```bash ```bash
# pi user environment: Enable I2C interface # pi user environment: Enable I2C interface
$ sudo raspi-config sudo raspi-config
``` ```
Select `Interfacing options->I2C` choose `<Yes>` and hit `Enter`, then go to `Finish` and you'll be prompted to reboot. Select `Interfacing options->I2C` choose `<Yes>` and hit `Enter`, then go to `Finish` and you'll be prompted to reboot.
@ -199,13 +199,13 @@ Install dependencies to use the `smbus-cffi` module and add your `homeassistant`
```bash ```bash
# pi user environment: Install I2C dependencies and utilities # pi user environment: Install I2C dependencies and utilities
$ sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev sudo apt-get install build-essential libi2c-dev i2c-tools python-dev libffi-dev
# pi user environment: Add homeassistant user to the I2C group # pi user environment: Add homeassistant user to the I2C group
$ sudo addgroup homeassistant i2c sudo addgroup homeassistant i2c
# pi user environment: Reboot Raspberry Pi to apply changes # pi user environment: Reboot Raspberry Pi to apply changes
$ sudo reboot sudo reboot
``` ```
### Check the I2C address of the sensor ### Check the I2C address of the sensor
@ -213,10 +213,11 @@ $ sudo reboot
After installing `i2c-tools`, a new utility is available to scan the addresses of the connected sensors: After installing `i2c-tools`, a new utility is available to scan the addresses of the connected sensors:
```bash ```bash
$ /usr/sbin/i2cdetect -y 1 /usr/sbin/i2cdetect -y 1
``` ```
It will output a table like this: It will output a table like this:
```text ```text
0 1 2 3 4 5 6 7 8 9 a b c d e f 0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- -- 00: -- -- -- -- -- -- -- -- -- -- -- -- --

View File

@ -10,7 +10,7 @@ ha_config_flow: true
The `dialogflow` integration is designed to be used with the [webhook](https://dialogflow.com/docs/fulfillment#webhook) integration of [Dialogflow](https://dialogflow.com/). When a conversation ends with a user, Dialogflow sends an action and parameters to the webhook. The `dialogflow` integration is designed to be used with the [webhook](https://dialogflow.com/docs/fulfillment#webhook) integration of [Dialogflow](https://dialogflow.com/). When a conversation ends with a user, Dialogflow sends an action and parameters to the webhook.
To be able to receive messages from DialogFlow, your Home Assistant instance needs to be accessible from the web ([Hass.io instructions](/addons/duckdns/)) and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)). Dialogflow will return fallback answers if your server does not answer or takes too long (more than 5 seconds). To be able to receive messages from DialogFlow, your Home Assistant instance needs to be accessible from the web and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)). Dialogflow will return fallback answers if your server does not answer or takes too long (more than 5 seconds).
Dialogflow could be [integrated](https://dialogflow.com/docs/integrations/) with many popular messaging, virtual assistant and IoT platforms. Dialogflow could be [integrated](https://dialogflow.com/docs/integrations/) with many popular messaging, virtual assistant and IoT platforms.

View File

@ -9,6 +9,12 @@ ha_release: 0.55
With the DuckDNS integration you can keep your DuckDNS record up to date. DuckDNS is a free dynamic DNS service that allows you to point a subdomain under `duckdns.org` at your computer. With the DuckDNS integration you can keep your DuckDNS record up to date. DuckDNS is a free dynamic DNS service that allows you to point a subdomain under `duckdns.org` at your computer.
<div class='note'>
If you are running the Home Assistant DuckDNS add-on this integration is not required. The add-on will keep your IP updated with DuckDNS.
</div>
## Configuration ## Configuration
To use the integration in your installation, add the following to your `configuration.yaml` file: To use the integration in your installation, add the following to your `configuration.yaml` file:
@ -39,9 +45,3 @@ Set the TXT record of your DuckDNS subdomain.
| ---------------------- | -------- | ----------- | | ---------------------- | -------- | ----------- |
| `txt` | no | Payload for the TXT record. | | `txt` | no | Payload for the TXT record. |
<div class='note'>
If you are running the Hass.io [DuckDNS add-on](/addons/duckdns/) this integration is not required. The add-on will keep your IP updated with DuckDNS.
</div>

View File

@ -152,11 +152,11 @@ Verify that the URLs above are using port 80, rather than port 8300 (i.e. `http:
### Platform specific instructions ### Platform specific instructions
#### Hass.io and Docker #### Home Assistant and Home Assistant Core on Docker
No further actions are required No further actions are required
#### Python venv #### Home Assistant Core in a Python venv
An additional step is required to run Home Assistant as a non-root user and use port 80. An additional step is required to run Home Assistant as a non-root user and use port 80.

View File

@ -11,13 +11,8 @@ The `ffmpeg` integration allows other Home Assistant integrations to process vid
<div class='note'> <div class='note'>
You need the `ffmpeg` binary in your system path. On Debian 8 or Raspbian (Jessie) you can install it from [debian-backports](https://backports.debian.org/Instructions/). If you want [hardware acceleration](https://trac.ffmpeg.org/wiki/HWAccelIntro) support on a Raspberry Pi, you will need to build from source by yourself. Windows binaries are available on the [FFmpeg](http://www.ffmpeg.org/) website. If you are running Home Assistant Core in a Python environment, you'll need have the `ffmpeg` binary in your system path.
</div> On Debian 8 or Raspbian (Jessie) you can install it from [debian-backports](https://backports.debian.org/Instructions/). If you want [hardware acceleration](https://trac.ffmpeg.org/wiki/HWAccelIntro) support on a Raspberry Pi, you will need to build from source by yourself. Windows binaries are available on the [FFmpeg](http://www.ffmpeg.org/) website.
<div class='note'>
If you are using [Hass.io](/hassio/) then just move forward to the configuration as all requirements are already fulfilled.
</div> </div>
## Configuration ## Configuration

View File

@ -91,7 +91,7 @@ camera:
content_type: 'image/svg+xml' content_type: 'image/svg+xml'
``` ```
### Local image with Hass.io ### Local image
You can show a static image with this platform. Just place the image here: `/config/www/your_image.png` You can show a static image with this platform. Just place the image here: `/config/www/your_image.png`

View File

@ -18,14 +18,10 @@ The computer running Home Assistant must support CEC, and of course be connected
### libcec ### libcec
This section only applies to users of Home Assistant Core in a Python virtual environment.
[libcec](https://github.com/Pulse-Eight/libcec) must be installed for this integration to work. Follow the installation instructions for your environment, provided at the link. `libcec` installs Python 3 bindings by default as a system Python module. If you are running Home Assistant in a [Python virtual environment](/docs/installation/virtualenv/), make sure it can access the system module, by either symlinking it or using the `--system-site-packages` flag. [libcec](https://github.com/Pulse-Eight/libcec) must be installed for this integration to work. Follow the installation instructions for your environment, provided at the link. `libcec` installs Python 3 bindings by default as a system Python module. If you are running Home Assistant in a [Python virtual environment](/docs/installation/virtualenv/), make sure it can access the system module, by either symlinking it or using the `--system-site-packages` flag.
<div class='note'>
If you are using [Hass.io](/hassio/) then just move forward to the configuration as all requirements are already fulfilled.
</div>
#### Symlinking into virtual environment #### Symlinking into virtual environment
Create a symlink to the `cec` installation including the _cec.so file. Keep in mind different installation methods will result in different locations of cec. Create a symlink to the `cec` installation including the _cec.so file. Keep in mind different installation methods will result in different locations of cec.

View File

@ -81,7 +81,7 @@ Configuration variables (interface):
{% configuration %} {% configuration %}
host: host:
description: IP address or Hostname of CCU/Homegear device or Hass.io add-on. description: IP address or hostname of CCU/Homegear device or Home Assistant add-on.
required: true required: true
type: string type: string
port: port:

View File

@ -22,7 +22,7 @@ There is currently support for the following device types within Home Assistant:
<div class='note'> <div class='note'>
Don't use option `server_host` on a Hass.io installation! The option option `server_host` should only be used on a Home Assistant Core installation!
</div> </div>

View File

@ -14,7 +14,7 @@ ha_config_flow: true
## Sending events from IFTTT to Home Assistant ## Sending events from IFTTT to Home Assistant
To be able to receive events from IFTTT, your Home Assistant instance needs to be accessible from the web ([Hass.io instructions](/addons/duckdns/)) and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)). To be able to receive events from IFTTT, your Home Assistant instance needs to be accessible from the web and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)).
### Setting up the integration ### Setting up the integration

View File

@ -43,16 +43,16 @@ logger:
logs: logs:
# log level for HA core # log level for HA core
homeassistant.core: fatal homeassistant.core: fatal
# log level for MQTT integration # log level for MQTT integration
homeassistant.components.mqtt: warning homeassistant.components.mqtt: warning
# log level for all python scripts # log level for all python scripts
homeassistant.components.python_script: warning homeassistant.components.python_script: warning
# individual log level for this python script # individual log level for this python script
homeassistant.components.python_script.my_new_script.py: debug homeassistant.components.python_script.my_new_script.py: debug
# log level for SmartThings lights # log level for SmartThings lights
homeassistant.components.smartthings.light: info homeassistant.components.smartthings.light: info
@ -69,7 +69,7 @@ logger:
The log entries are in the form The log entries are in the form
*timestamp* *log-level* *thread* [**namespace**] *message* *timestamp* *log-level* *thread* [**namespace**] *message*
where **namespace** is the *<component_namespace>* currently logging. where **namespace** is the *<component_namespace>* currently logging.
{% configuration %} {% configuration %}
default: default:
@ -87,12 +87,12 @@ where **namespace** is the *<component_namespace>* currently logging.
type: string type: string
{% endconfiguration %} {% endconfiguration %}
In the example, do note the difference between 'glances_api' and 'homeassistant.components.glances' namespaces, In the example, do note the difference between 'glances_api' and 'homeassistant.components.glances' namespaces,
both of which are at root. They are logged by different APIs. both of which are at root. They are logged by different APIs.
If you want to know the namespaces in your own environment then check your log files on startup. If you want to know the namespaces in your own environment then check your log files on startup.
You will see INFO log messages from homeassistant.loader stating `loaded <component> from <namespace>`. You will see INFO log messages from homeassistant.loader stating `loaded <component> from <namespace>`.
Those are the namespaces available for you to set a `log level` against. Those are the namespaces available for you to set a `log level` against.
### Log Levels ### Log Levels
@ -144,11 +144,10 @@ The log information are stored in the
and you can read it with the command-line tool `cat` or follow it dynamically and you can read it with the command-line tool `cat` or follow it dynamically
with `tail -f`. with `tail -f`.
If you are a Hass.io user, you can use the example below, when logged in through You can use the example below, when logged in through the [SSH add-on](/addons/ssh/):
the [SSH add-on](/addons/ssh/):
```bash ```bash
$ tail -f /config/home-assistant.log tail -f /config/home-assistant.log
``` ```
On Docker you can use your host command line directly - follow the logs dynamically with: On Docker you can use your host command line directly - follow the logs dynamically with:

View File

@ -8,7 +8,7 @@ ha_release: 0.38
ha_config_flow: true ha_config_flow: true
--- ---
To be able to receive webhooks from Mailgun, your Home Assistant instance needs to be accessible from the web ([Hass.io instructions](/addons/duckdns/)) and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)). To be able to receive webhooks from Mailgun, your Home Assistant instance needs to be accessible from the web and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)).
To set it up, go to the integrations page in the configuration screen and find Mailgun. Click on configure. Follow the instructions on the screen to configure Mailgun. To set it up, go to the integrations page in the configuration screen and find Mailgun. Click on configure. Follow the instructions on the screen to configure Mailgun.

View File

@ -16,7 +16,7 @@ The `mcp23017` integration is the base for all related mcp23017 platforms in Hom
For more details about the MCP23017 I2C I/O port expander you can find its datasheet here: [MCP23017](https://www.microchip.com/wwwproducts/en/MCP23017). For more details about the MCP23017 I2C I/O port expander you can find its datasheet here: [MCP23017](https://www.microchip.com/wwwproducts/en/MCP23017).
If you are using Hass.io on HassOS you cant use existing methods to enable the I2C bus on a Raspberry Pi, you will have to [enable the I2C interface in the Hass.io configuration](https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/raspberrypi.md#i2c) using a USB stick. To accomplish that, follow this step by step instructions: [Enable HassOS i2c](https://www.home-assistant.io/hassio/enable_i2c). If you are using the Home Assistant Operating System you cant use existing methods to enable the I2C bus on a Raspberry Pi, you will have to [enable the I2C interface manually](https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/raspberrypi.md#i2c) using a USB stick. To accomplish that, follow this step by step instructions: [Enable Home Assistant Operating System i2c](https://www.home-assistant.io/hassio/enable_i2c).
## Binary Sensor ## Binary Sensor

View File

@ -32,6 +32,7 @@ sensor:
- **temperature** - **temperature**
Full example: Full example:
```yaml ```yaml
sensor: sensor:
- platform: mhz19 - platform: mhz19
@ -42,7 +43,7 @@ sensor:
- temperature - temperature
``` ```
## Raspberry Pi 3(+) GPIO UART and Hass.io ## Raspberry Pi GPIO UART and the Home Assistant Operating System
To directly connect the sensor on the GPIO pins of a RPi, first append the following to `config.txt` in the boot directory: To directly connect the sensor on the GPIO pins of a RPi, first append the following to `config.txt` in the boot directory:

View File

@ -19,8 +19,8 @@ There are "Chinese" and "International" versions available and there is a [repor
Before configuring Home Assistant you need a Bluetooth backend and the MAC address of your sensor. Depending on your operating system, you may have to configure the proper Bluetooth backend for your system: Before configuring Home Assistant you need a Bluetooth backend and the MAC address of your sensor. Depending on your operating system, you may have to configure the proper Bluetooth backend for your system:
- On [Hass.io](/hassio/installation/): Miflora will work out of the box. - On [Home Assistant](/hassio/installation/): Miflora will work out of the box.
- On a [generic Docker installation](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host. - On [Home Assistant Core on Docker](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host.
- On other Linux systems: - On other Linux systems:
- Preferred solution: Install the `bluepy` library (via pip). When using a virtual environment, make sure to install the library in the right one. - Preferred solution: Install the `bluepy` library (via pip). When using a virtual environment, make sure to install the library in the right one.
 - Fallback solution: Install `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth`, `bluez-deprecated`  - Fallback solution: Install `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth`, `bluez-deprecated`

View File

@ -14,8 +14,8 @@ The `mitemp_bt` sensor platform allows one to monitor room temperature and humid
Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system: Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system:
- On [Hass.io](/hassio/installation/): `mitemp_bt` will work out of the box as long as the host supports Bluetooth (like the Raspberry Pi does). - On [Home Assistant](/hassio/installation/): `mitemp_bt` will work out of the box as long as the host supports Bluetooth (like the Raspberry Pi does).
- On a [generic Docker installation](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host. - On a [Home Assistant Core on Docker](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host.
- On other Linux systems: - On other Linux systems:
- Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one. - Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one.
- Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth` or `bluez-deprecated`. - Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth` or `bluez-deprecated`.

View File

@ -13,11 +13,11 @@ As an alternative to the router-based device tracking, it is possible to directl
Please keep in mind that modern smart phones will usually turn off WiFi when they are idle. Simple trackers like this may not be reliable on their own. Please keep in mind that modern smart phones will usually turn off WiFi when they are idle. Simple trackers like this may not be reliable on their own.
</div> </div>
You might have to install the packages for `arp` and `nmap`. On Debian based hosts (for example Raspbian) do so by running `$ sudo apt-get install net-tools nmap`. On a Fedora host run `$ sudo dnf -y install nmap`.
<div class='note'> <div class='note'>
If you are using [Hass.io](/hassio/) then just move forward to the configuration as all requirements are already fulfilled. If you are running Home Assistant Core in a Python virtual environment, you might have to install the packages for `arp` and `nmap`.
On Debian based hosts (for example Raspbian) do so by running `sudo apt-get install net-tools nmap`.
On a Fedora host run `sudo dnf -y install nmap`.
</div> </div>
@ -78,6 +78,7 @@ device_tracker:
- 10.0.0.2 - 10.0.0.2
- 10.0.0.15 - 10.0.0.15
``` ```
In the above example, Nmap will be call with the process: In the above example, Nmap will be call with the process:
`nmap -oX - 192.168.1.1/24 10.0.0.2 10.0.0.15 -F --host-timeout 5s` `nmap -oX - 192.168.1.1/24 10.0.0.2 10.0.0.15 -F --host-timeout 5s`
@ -88,10 +89,11 @@ An example of how the Nmap scanner can be customized:
On Linux systems (such as Hass.io) you can extend the functionality of Nmap, without having to run it as root, by using *Linux capabilities*. Be sure to specify the full path to wherever you installed Nmap: On Linux systems (such as Hass.io) you can extend the functionality of Nmap, without having to run it as root, by using *Linux capabilities*. Be sure to specify the full path to wherever you installed Nmap:
```bash ```bash
$ sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip /usr/bin/nmap sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip /usr/bin/nmap
``` ```
And you can set up the device tracker as And you can set up the device tracker as
```yaml ```yaml
- platform: nmap_tracker - platform: nmap_tracker
hosts: 192.168.1.1-25 hosts: 192.168.1.1-25

View File

@ -27,7 +27,7 @@ The 1-Wire bus can be connected directly to the IO pins of Raspberry Pi or using
## Raspberry Pi setup ## Raspberry Pi setup
In order to setup 1-Wire support on Raspberry Pi, you'll need to edit `/boot/config.txt` following [this documentation](https://www.waveshare.com/wiki/Raspberry_Pi_Tutorial_Series:_1-Wire_DS18B20_Sensor#Enable_1-Wire). In order to setup 1-Wire support on Raspberry Pi, you'll need to edit `/boot/config.txt` following [this documentation](https://www.waveshare.com/wiki/Raspberry_Pi_Tutorial_Series:_1-Wire_DS18B20_Sensor#Enable_1-Wire).
To edit `/boot/config.txt` on Hass.io use [this documentation](https://developers.home-assistant.io/docs/en/hassio_debugging.html) to enable SSH and edit `/mnt/boot/config.txt` via `vi`. To edit `/boot/config.txt` on the Home Assistant Operating System, use [this documentation](https://developers.home-assistant.io/docs/en/hassio_debugging.html) to enable SSH and edit `/mnt/boot/config.txt` via `vi`.
## Interface adapter setup ## Interface adapter setup
@ -49,6 +49,7 @@ Connect to your database using the instructions from [Database section](/docs/ba
```sql ```sql
SELECT entity_id, COUNT(*) as count FROM states GROUP BY entity_id ORDER BY count DESC LIMIT 10; SELECT entity_id, COUNT(*) as count FROM states GROUP BY entity_id ORDER BY count DESC LIMIT 10;
``` ```
Alter the names of sensors using the following examples: Alter the names of sensors using the following examples:
```sql ```sql

View File

@ -26,7 +26,7 @@ pi_hole:
{% configuration %} {% configuration %}
host: host:
description: > description: >
The hostname (and port), e.g. '192.168.0.3:4865' of the host where Pi-hole is running. Hass.io add-on users should be sure to specify port `4865`. The hostname (and port), e.g. '192.168.0.3:4865' of the host where Pi-hole is running. Home Assistant add-on users should be sure to specify port `4865`.
required: true required: true
type: string type: string
name: name:
@ -62,7 +62,7 @@ api_key:
### Full examples ### Full examples
Single Pi-hole running via Hass.io add-on: Single Pi-hole running via Home Assistant add-on:
```yaml ```yaml
pi_hole: pi_hole:
@ -105,7 +105,7 @@ Disables configured Pi-hole(s) for the specified amount of time.
| Service data attribute | Required | Type | Description | | Service data attribute | Required | Type | Description |
| ---------------------- | -------- | -------- | ----------- | | ---------------------- | -------- | -------- | ----------- |
| `duration` | `True` | timedelta | Time for which Pi-hole should be disabled | | `duration` | `True` | timedelta | Time for which Pi-hole should be disabled |
| `name` | `False` | string | If preset, disables the named Pi-hole, otherwise, disables all configured Pi-holes | | `name` | `False` | string | If preset, disables the named Pi-hole, otherwise, disables all configured Pi-holes |
_Note: This service requires `api_key` to be specified in the configuration._ _Note: This service requires `api_key` to be specified in the configuration._

View File

@ -39,14 +39,14 @@ The `ps4` integration allows you to control a
The PlayStation 4 integration requires the use of privileged ports to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance, you may need to allow usage of privileged ports manually. The PlayStation 4 integration requires the use of privileged ports to work correctly, specifically UDP port 987 and TCP port 997. Depending on your OS of your Home Assistant instance, you may need to allow usage of privileged ports manually.
<div class='note warning'> <div class='note warning'>
Do not run your <b>Home Assistant</b> instance itself as <b>root</b> or with <b>root/sudo privileges</b> to accomplish this. This would create a security risk for your host system. Do not run your <b>Home Assistant Core</b> instance itself as <b>root</b> or with <b>root/sudo privileges</b> to accomplish this. This would create a security risk for your host system.
</div> </div>
There are varying methods to perform this, dependent on your OS that is running Home Assistant. Specifically, your *Python Interpreter*, which runs your Home Assistant instance, needs access to the mentioned ports. There are varying methods to perform this, dependent on your OS that is running Home Assistant. Specifically, your *Python Interpreter*, which runs your Home Assistant instance, needs access to the mentioned ports.
<div class='note'> <div class='note'>
If your Home Assistant device is running **Hass.io** on **HassOS**, it does not require additional configuration. Additional configuration is only required for Home Assistant Core users **not** running on Docker.
</div> </div>

View File

@ -19,9 +19,12 @@ There is currently support for the following device types within Home Assistant:
Set the jumpers on the PiFace board for address 0 (JP1: 1-2, JP2: 1-2). Set the jumpers on the PiFace board for address 0 (JP1: 1-2, JP2: 1-2).
## Use with HassOS ## Using with the Home Assistant Operating System
Note that the PiFace Digital 2 uses the Raspberry Pi SPI port, which is disabled by default when using [HassOS](https://github.com/home-assistant/hassos). When using HassOS, you must mount the SD card on another computer and access the boot partition on the card. Edit the `config.txt` file and add the line `dtparam=spi=on` to the end. This should enable SPI when HassOS is booted and allow Home Assistant to access the PiFace Digital 2 board. Note that the PiFace Digital 2 uses the Raspberry Pi SPI port, which is disabled by default when using the [Home Assistant Operating System](https://github.com/home-assistant/hassos).
You must mount the SD card on another computer and access the boot partition on the card. Edit the `config.txt` file and add the line `dtparam=spi=on` to the end.
This should enable SPI when the Home Assistant Operating System is booted to access the PiFace Digital 2 board.
## Binary Sensor ## Binary Sensor

View File

@ -37,7 +37,7 @@ host:
required: true required: true
type: string type: string
port: port:
description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - for installs other than Hass.io or Docker you may need to install a Python package, see below. description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - For Home Assistant Core installations, you may need to install a Python package, see below.
required: false required: false
type: integer type: integer
default: automatically detected default: automatically detected
@ -166,11 +166,7 @@ media_content_type: channel
It's possible to switch between the 2 sources `TV` and `HDMI`. It's possible to switch between the 2 sources `TV` and `HDMI`.
### Hass.io ### Home Assistant & Home Assistant Core on Docker
No additional actions are required
### Docker
No additional actions are required No additional actions are required

View File

@ -11,11 +11,9 @@ ha_iot_class: Local Polling
The `seven_segments` image processing platform allows you to read physical seven segments displays through Home Assistant. [`ssocr`](https://www.unix-ag.uni-kl.de/~auerswal/ssocr/) is used to extract the value shown on the display which is observed by a [camera](/integrations/camera/). The `seven_segments` image processing platform allows you to read physical seven segments displays through Home Assistant. [`ssocr`](https://www.unix-ag.uni-kl.de/~auerswal/ssocr/) is used to extract the value shown on the display which is observed by a [camera](/integrations/camera/).
<div class='note'> ## Home Assistant Core Requirements
If you are using [Hass.io](/hassio/) then just move forward to the configuration as all requirements are already fulfilled. If you are running Home Assistant Core in a Python virtual environment, you need to ensure the following requirements are met.
</div>
`ssocr` needs to be available on your system. Check the installation instruction below: `ssocr` needs to be available on your system. Check the installation instruction below:
@ -30,6 +28,8 @@ sudo make PREFIX=/usr install # On most systems
make deb # (Optional) This allows you to make a deb so that you apt is aware of ssocr make deb # (Optional) This allows you to make a deb so that you apt is aware of ssocr
``` ```
## Configuration
To enable the OCR of a seven segment display in your installation, add the following to your `configuration.yaml` file: To enable the OCR of a seven segment display in your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
@ -105,7 +105,7 @@ source:
It's suggested that the first attempt to determine the needed parameters is using `ssocr` directly. This may require a couple of iterations to get the result It's suggested that the first attempt to determine the needed parameters is using `ssocr` directly. This may require a couple of iterations to get the result
```bash ```bash
$ ssocr -D erosion crop 390 250 490 280 -t 20 -d 4 seven-seg.png ssocr -D erosion crop 390 250 490 280 -t 20 -d 4 seven-seg.png
``` ```
This would lead to the following entry for the `configuration.yaml` file: This would lead to the following entry for the `configuration.yaml` file:

View File

@ -33,7 +33,7 @@ To get started, add the devices to your `configuration.yaml` file.
tellstick: tellstick:
``` ```
For Hass.io users there is a [TellStick add-on](/addons/tellstick/) available. There is a [TellStick add-on](/addons/tellstick/) available in the Home Assistant add-on store.
```yaml ```yaml
# Example configuration.yaml entry for Hass.io with the TellStick add-on # Example configuration.yaml entry for Hass.io with the TellStick add-on
@ -49,7 +49,7 @@ signal_repetitions:
type: integer type: integer
default: 1 default: 1
host: host:
description: If you run TellStick on another server or with the Hass.io add-on. description: If you run TellStick on another server or with the Home Assistant add-on.
required: inclusive required: inclusive
type: string type: string
port: port:

View File

@ -11,7 +11,7 @@ ha_codeowners:
- '@ludeeus' - '@ludeeus'
--- ---
`Traccar` uses GPS for tracking and has support for over 1500 different types of devices. One option is to track the [Traccar Client](https://www.traccar.org/client/) app on a smartphone via `webhook`. The other option is to connect to an existing [Traccar Server](https://www.traccar.org/server/) installation which is also available as Hass.io addon. `Traccar` uses GPS for tracking and has support for over 1500 different types of devices. One option is to track the [Traccar Client](https://www.traccar.org/client/) app on a smartphone via `webhook`. The other option is to connect to an existing [Traccar Server](https://www.traccar.org/server/) installation which is also available as Home Assistant add-on.
## Traccar Client ## Traccar Client

View File

@ -51,7 +51,7 @@ allow_tradfri_groups:
After updating your IKEA Trådfri Gateway firmware it might be necessary to repeat the configuration process. One error you might experience after a firmware update is `Fatal DTLS error: code 115`. If you encounter problems: After updating your IKEA Trådfri Gateway firmware it might be necessary to repeat the configuration process. One error you might experience after a firmware update is `Fatal DTLS error: code 115`. If you encounter problems:
- when configured using the integration: remove the integration through Settings > Integrations > Tradfri > delete (trash can icon) - when configured using the integration: remove the integration through Settings > Integrations > Tradfri > delete (trash can icon)
- with manual configuration: delete the `.tradfri_psk.conf` file in your `/.homeassistant` directory (`/config` directory if using Hass.io or Docker) - with manual configuration: delete the `.tradfri_psk.conf` file in your `/config` directory (`/.homeassistant` directory if using Home Assistant Core)
Then restart Home Assistant. When prompted, enter the security key and click *configure*, just like during initial setup. Then restart Home Assistant. When prompted, enter the security key and click *configure*, just like during initial setup.

View File

@ -39,7 +39,7 @@ auth_token:
After configuring the base Twilio component, add and configure either or both of the [Twilio SMS](/integrations/twilio_sms) and [Twilio Phone](/integrations/twilio_call) integrations to utilize the notification functionality. After configuring the base Twilio component, add and configure either or both of the [Twilio SMS](/integrations/twilio_sms) and [Twilio Phone](/integrations/twilio_call) integrations to utilize the notification functionality.
To be able to receive events from Twilio, your Home Assistant instance needs to be accessible from the web ([Hass.io instructions](/addons/duckdns/)) and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)). To be able to receive events from Twilio, your Home Assistant instance needs to be accessible from the web and you need to have the `base_url` configured for the HTTP integration ([docs](/integrations/http/#base_url)).
To set it up, go to the integrations page in the configuration screen and find Twilio. Click on configure. Follow the instructions on the screen to configure Twilio. To set it up, go to the integrations page in the configuration screen and find Twilio. Click on configure. Follow the instructions on the screen to configure Twilio.

View File

@ -10,7 +10,7 @@ ha_codeowners:
- '@home-assistant/core' - '@home-assistant/core'
--- ---
The `updater` binary sensor will check daily for new releases. The state will be "on" when an update is available. Otherwise, the state will be "off". The newer version, as well as the link to the release notes, are attributes of the updater. As [Hass.io](/hassio/) has its own schedule for release it doesn't make sense to use this binary sensor on Hass.io. The `updater` binary sensor will check daily for new releases. The state will be "on" when an update is available. Otherwise, the state will be "off". The newer version, as well as the link to the release notes, are attributes of the updater.
The updater integration will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/tree/dev/homeassistant/components/updater). The updater integration will also collect basic information about the running Home Assistant instance and its environment. The information includes the current Home Assistant version, the time zone, Python version and operating system information. No identifiable information (i.e., IP address, GPS coordinates, etc.) will ever be collected. If you are concerned about your privacy, you are welcome to scrutinize the Python [source code](https://github.com/home-assistant/home-assistant/tree/dev/homeassistant/components/updater).
@ -65,6 +65,7 @@ It is possible to report the integrations that you are using to the Home Assista
For an added bonus, an automation integration can be created to send a message with a notifier when that state of this component's entity changes. For an added bonus, an automation integration can be created to send a message with a notifier when that state of this component's entity changes.
{% raw %} {% raw %}
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
automation: automation:
@ -79,4 +80,5 @@ automation:
data_template: data_template:
message: "Home Assistant {{ state_attr('binary_sensor.updater', 'newest_version') }} is available." message: "Home Assistant {{ state_attr('binary_sensor.updater', 'newest_version') }} is available."
``` ```
{% endraw %} {% endraw %}

View File

@ -46,7 +46,7 @@ source:
default: local default: local
{% endconfiguration %} {% endconfiguration %}
### Supported images for Hass.io and Docker ### Supported images for Home Assistant
`default`, `qemux86`, `qemux86-64`, `qemuarm`, `qemuarm-64`, `intel-nuc`, `raspberrypi`, `raspberrypi2`, `raspberrypi3`, `raspberrypi3-64`, `raspberrypi4`, `raspberrypi4-64`, `tinker`, `odroid-c2`, `odroid-xu` `default`, `qemux86`, `qemux86-64`, `qemuarm`, `qemuarm-64`, `intel-nuc`, `raspberrypi`, `raspberrypi2`, `raspberrypi3`, `raspberrypi3-64`, `raspberrypi4`, `raspberrypi4-64`, `tinker`, `odroid-c2`, `odroid-xu`

View File

@ -10,6 +10,14 @@ ha_iot_class: Local Polling
The `vlc` platform allows you to control [VLC media player](https://www.videolan.org/vlc/index.html). The `vlc` platform allows you to control [VLC media player](https://www.videolan.org/vlc/index.html).
<div class='note'>
The VLC media player integration, is currently only available for installations that are based on the Home Assistant Core in a Python virtual environment.
</div>
## Configuration
To add a VLC media player to your installation, add the following to your `configuration.yaml` file: To add a VLC media player to your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
@ -45,7 +53,7 @@ media_player:
arguments: '--alsa-audio-device=hw:1,0' arguments: '--alsa-audio-device=hw:1,0'
``` ```
##### Additional configuration on macOS ## Additional configuration on macOS
On macOS `python-vlc` wont find the VLC plugin directory unless you add this to the users `.bash_profile` that is running Home Assistant: On macOS `python-vlc` wont find the VLC plugin directory unless you add this to the users `.bash_profile` that is running Home Assistant:
@ -53,14 +61,10 @@ On macOS `python-vlc` wont find the VLC plugin directory unless you add this
export VLC_PLUGIN_PATH=$VLC_PLUGIN_PATH:/Applications/VLC.app/Contents/MacOS/plugins export VLC_PLUGIN_PATH=$VLC_PLUGIN_PATH:/Applications/VLC.app/Contents/MacOS/plugins
``` ```
##### Additional configuration for Rasperry Pi ## Additional configuration for Raspberry Pi
You need to add the `homeassistant` user to the `audio` group: You need to add the `homeassistant` user to the `audio` group:
```bash ```bash
sudo usermod -a -G audio homeassistant sudo usermod -a -G audio homeassistant
``` ```
##### VLC currently not supported with Hass.io
According to the forum topic ["How to add VLC into my Hassio"](https://community.home-assistant.io/t/how-to-add-vlc-into-my-hassio/23000/5), it is not possible to install packages like VLC on Hass.io.

View File

@ -62,6 +62,7 @@ media_player:
password: your-secure-password password: your-secure-password
``` ```
##### Additional configuration for Rasperry Pi ## Home Assistant Add-on
You can run a VLC Media Player inside your Hass.io installation using the [hassio-local-vlc add-on](https://github.com/rodripf/hassio-local-vlc). Using it you can play files on the local network, Internet or files and playlist locally saved to the /share folder of your Hass.io installation. You can run a VLC Media Player on your Home Assistant installation using the a community provided [add-on](https://github.com/rodripf/hassio-local-vlc).
Using it you can play files on the local network, Internet or files and playlist locally saved to the `/share` folder of your Home Assistant installation.

View File

@ -150,7 +150,7 @@ Using a Philips Hue Dimmer Switch is probably the easiest way to factory-reset y
Follow the instructions on [https://github.com/vanviegen/hue-thief/](https://github.com/vanviegen/hue-thief/) (EZSP-based Zigbee USB stick required) Follow the instructions on [https://github.com/vanviegen/hue-thief/](https://github.com/vanviegen/hue-thief/) (EZSP-based Zigbee USB stick required)
### ZHA Start up issue with Home Assistant Docker/Hass.io installs on Linux hosts ### ZHA Start up issue with Home Assistant Supervised or Home Assistant Core on Docker
On Linux hosts ZHA can fail to start during HA startup or restarts because the Zigbee USB device is being claimed by the host's modemmanager service. To fix this disable the modemmanger on the host system. On Linux hosts ZHA can fail to start during HA startup or restarts because the Zigbee USB device is being claimed by the host's modemmanager service. To fix this disable the modemmanger on the host system.

View File

@ -7,11 +7,11 @@ The onboarding process takes care of the initial setup for Home Assistant, such
<div class='note'> <div class='note'>
The steps below only apply if you've installed Home Assistant via Hass.io. If you've used another installation method, [see here](/docs/configuration/). The steps below do not apply to Home Assistant Core installations, for those types of installations, [see here](/docs/configuration/).
</div> </div>
We are going to help you make your first changes to `configuration.yaml`. To do this, we are going to install an add-on from the Hass.io add-on store: the Configurator. To get to the add-on store, click on the menu icon in the top left, then click on Hass.io. On the new page, open the add-on store tab. We are going to help you make your first changes to `configuration.yaml`. To do this, we are going to install an add-on from the Home Assistant add-on store: the Configurator. To get to the add-on store, click on the menu icon in the top left, then click on Supervisor. On the new page, open the add-on store tab.
<p class='img'> <p class='img'>
<img src='/images/hassio/screenshots/main_panel_addon_store.png' /> <img src='/images/hassio/screenshots/main_panel_addon_store.png' />
@ -53,15 +53,15 @@ Screenshot of the "General" page in the configuration panel.
</p> </p>
<div class='note'> <div class='note'>
If you have watched any videos about setting up Home Assistant using configuration.yaml (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. [See here](/integrations/default_config/) for more information on what's included in that line. If you have watched any videos about setting up Home Assistant using `configuration.yaml` (particularly ones that are old), you might notice your default configuration file is much smaller than what the videos show. Don't be concerned, you haven't done anything wrong. Many items in the default configuration files shown in those old videos are now included in the `default_config:` line that you see in your configuration file. [See here](/integrations/default_config/) for more information on what's included in that line.
</div> </div>
### Editing configuration via Samba/Windows Networking ### Editing configuration via Samba/Windows Networking
Maybe you are not a big fan of our web editor and want to use a text editor on your computer instead. This is possible by sharing the configuration over the network using the Samba add-on, which can also be installed from the Hass.io add-on store. This will make your configuration accessible via the network tab on your computer. Maybe you are not a big fan of our web editor and want to use a text editor on your computer instead. This is possible by sharing the configuration over the network using the Samba add-on, which can also be installed from the Home Assistant add-on store. This will make your configuration accessible via the network tab on your computer.
Go to the add-on store and look for Samba in the core section. After you have installed the add-on, click on START. Hass.io should now be available in the networking tab on your computer. Go to the add-on store and look for Samba in the core section. After you have installed the add-on, click on START. Home Assistant should now be available in the networking tab on your computer.
We suggest that to edit `configuration.yaml`, you use the free text editor [Visual Studio Code](https://code.visualstudio.com/) in combination with the [Home Assistant Configuration Helper extension](https://marketplace.visualstudio.com/items?itemName=keesschollaart.vscode-home-assistant). We suggest that to edit `configuration.yaml`, you use the free text editor [Visual Studio Code](https://code.visualstudio.com/) in combination with the [Home Assistant Configuration Helper extension](https://marketplace.visualstudio.com/items?itemName=keesschollaart.vscode-home-assistant).

View File

@ -19,13 +19,13 @@ So here are guidelines:
- Do not talk about YAML if it can be partially/fully done in UI. - Do not talk about YAML if it can be partially/fully done in UI.
- Do not tell people about stuff they can do later. This can be added to a - Do not tell people about stuff they can do later. This can be added to a
2nd tier guide. 2nd tier guide.
- The first page of the guide is for installation, hence Hass.io specific. - The first page of the guide is for installation, hence Home Assistant specific.
Other pages should not refer to it except for the page introducing the last Other pages should not refer to it except for the page introducing the last
page that introduces `configuration.yaml`. page that introduces `configuration.yaml`.
{% endcomment %} {% endcomment %}
This guide will help you get Home Assistant running on a Raspberry Pi. The easiest way to do this is by using the [Hass.io](/hassio/) installer, which is our all-in-one solution that turns Raspberry Pis and other devices into the ultimate home automation hub. This guide will help you get Home Assistant running on a Raspberry Pi, turning your Raspberry Pi into the ultimate home automation hub.
Follow this guide if you want to get started with Home Assistant easily or if you have little to no Linux experience. For advanced users (or if you don't have a [device that is supported by this guide][supported]), check out our [alternative installation methods](/docs/installation/). Once you finish your alternative installation, you can continue at the [next step][next-step]. Follow this guide if you want to get started with Home Assistant easily or if you have little to no Linux experience. For advanced users (or if you don't have a [device that is supported by this guide][supported]), check out our [alternative installation methods](/docs/installation/). Once you finish your alternative installation, you can continue at the [next step][next-step].
@ -42,7 +42,7 @@ We will need a few things to get started with installing Home Assistant. The Ras
### Software requirements ### Software requirements
- Download and extract the HassOS image for [your device](/hassio/installation/) - Download and extract the Home Assistant image for [your device](/hassio/installation/)
- Download [balenaEtcher] to write the image to an SD card - Download [balenaEtcher] to write the image to an SD card
[balenaEtcher]: https://www.balena.io/etcher [balenaEtcher]: https://www.balena.io/etcher
@ -50,7 +50,7 @@ We will need a few things to get started with installing Home Assistant. The Ras
### Installation ### Installation
1. Put the SD card in your card reader. 1. Put the SD card in your card reader.
2. Open balenaEtcher, select the HassOS image and flash it to the SD card. 2. Open balenaEtcher, select the Home Assistant image and flash it to the SD card.
3. Unmount the SD card and remove it from your card reader. 3. Unmount the SD card and remove it from your card reader.
4. Follow this step if you want to configure Wi-Fi or a static IP address (this step requires a USB stick). Otherwise, move to step 5. 4. Follow this step if you want to configure Wi-Fi or a static IP address (this step requires a USB stick). Otherwise, move to step 5.
- Format a USB stick to FAT32 with the volume name `CONFIG`. - Format a USB stick to FAT32 with the volume name `CONFIG`.

View File

@ -1,93 +1,96 @@
--- ---
title: "Hass.io via the Command line" title: "Home Assistant via the command line"
description: "Command line utility to control Hass.io." description: "Command line utility to control Home Assistant."
--- ---
<p class='img'> <p class='img'>
<img src='/images/hassio/screenshots/ssh-upgrade.png'> <img src='/images/hassio/screenshots/ssh-upgrade.png'>
Hass.io upgrade process from the SSH command line Home Assistant upgrade process from the SSH command line
</p> </p>
On the SSH command line, you can use the `hassio` command to retrieve logs, check the details of connected hardware, and more. On the SSH command line, you can use the `ha` command to retrieve logs, check the details of connected hardware, and more.
## Home Assistant ## Home Assistant
```bash ```bash
hassio homeassistant check ha core check
hassio homeassistant info ha core info
hassio homeassistant logs ha core logs
hassio homeassistant options ha core options
hassio homeassistant rebuild ha core rebuild
hassio homeassistant restart ha core restart
hassio homeassistant start ha core start
hassio homeassistant stats ha core stats
hassio homeassistant stop ha core stop
hassio homeassistant update ha core update
``` ```
## Supervisor ## Supervisor
```bash ```bash
hassio supervisor info ha supervisor info
hassio supervisor logs ha supervisor logs
hassio supervisor reload ha supervisor reload
hassio supervisor update ha supervisor update
``` ```
## Host ## Host
```bash ```bash
hassio host reboot ha host reboot
hassio host shutdown ha host shutdown
hassio host update ha host update
``` ```
## Hardware ## Hardware
```bash ```bash
hassio hardware info ha hardware info
hassio hardware audio ha hardware audio
``` ```
## Usage examples ## Usage examples
To update Home Assistant to a specific version, use the command: To update Home Assistant to a specific version, use the command:
```bash ```bash
hassio homeassistant update --version=x.y.z ha core update --version=x.y.z
``` ```
Replace x.y.z with the desired version like `--version=0.74.2` Replace x.y.z with the desired version like `--version=0.74.2`
You can get a better description of the CLI capabilities by typing `hassio help`: You can get a better description of the CLI capabilities by typing `ha help`:
```bash ```bash
The Home Assistant CLI is a small and simple command line utility that allows
you to control and configure different aspects of Home Assistant
Usage: Usage:
hassio [command] ha [command]
Available Commands: Available Commands:
addons Install, update, remove and configure Hass.io add-ons addons Install, update, remove and configure Home Assistant add-ons
dns Get information, update or configure the Hass.io DNS server authentication Authentication for Home Assistant users.
hardware Provides hardware information about your system core Provides control of the Home Assistant Core
hassos HassOS specific for updating, info and configuration imports dns Get information, update or configure the Home Assistant DNS server
help Help about any command hardware Provides hardware information about your system
homeassistant Provides control of Home Assistant running on Hass.io help Help about any command
host Control the host/system that Hass.io is running on host Control the host/system that Home Assistant is running on
info Provides a general Hass.io information overview info Provides a general Home Assistant information overview
snapshots Create, restore and remove snapshot backups os Operating System specific for updating, info and configuration imports
supervisor Monitor, control and configure the Hass.io Supervisor snapshots Create, restore and remove snapshot backups
supervisor Monitor, control and configure the Home Assistant Supervisor
Flags: Flags:
--api-token string Hass.io API token --api-token string Home Assistant Supervisor API token
--config string Optional config file (default is $HOME/.homeassistant.yaml) --config string Optional config file (default is $HOME/.homeassistant.yaml)
--endpoint string Endpoint for Hass.io Supervisor ( default is 'hassio' ) --endpoint string Endpoint for Home Assistant Supervisor ( default is 'supervisor' )
-h, --help help for hassio -h, --help help for ha
--log-level string Log level (defaults to Warn) --log-level string Log level (defaults to Warn)
--no-progress Disable the progress spinner --no-progress Disable the progress spinner
--raw-json Output raw JSON from the API --raw-json Output raw JSON from the API
Use "hassio [command] --help" for more information about a command. Use "ha [command] --help" for more information about a command.
``` ```
## Console access ## Console access
You can also access HassOS via a directly connected keyboard and monitor, the console. To log in to the physical console the username is `root`, with no password. You can also access the Home Assistant Operating System via a directly connected keyboard and monitor, the console. To log in to the physical console the username is `root`, with no password.

View File

@ -1,11 +1,12 @@
--- ---
title: "Enable HassOS i2c" title: "Enable i2c on the Home Assistant Operating System"
description: "Instructions on how to enable I2C on a Raspberry PI for Hass.io." description: "Instructions on how to enable I2C on a Raspberry PI"
--- ---
Hass.io is a managed environment, which means you can't use existing methods to enable the I2C bus on a Raspberry Pi. Home Assistant using the Home Assistant Operating System, is a managed environment.
Which means you can't use existing methods to enable the I2C bus on a Raspberry Pi.
If you're attempting to add an external sensor, you will have to [enable the I2C interface in the Hass.io configuration](https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/raspberrypi.md#i2c) using a USB stick. If you're attempting to add an external sensor, you will have to [enable the I2C interface in the Home Assistant configuration](https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/raspberrypi.md#i2c) using a USB stick.
## Step by step instructions ## Step by step instructions
@ -38,8 +39,8 @@ Format a USB stick with FAT32/EXT4/NTFS and name the drive `CONFIG` (uppercase).
### Step 3 - Load the new USB configuration ### Step 3 - Load the new USB configuration
- Insert the USB drive into your Raspberry Pi. - Insert the USB drive into your Raspberry Pi.
- Now go to your Home Assistant web interface, in the sidebar click **Hass.io** > **System**. - Now go to your Home Assistant web interface, in the sidebar click **Supervisor** > **System**.
- Now click `Import from USB`. - Now click `Import from USB`.
- This will restart your Hass.io instance, and load the new USB configuration. - This will restart your Home Assistant instance, and load the new USB configuration.
When the service has restarted, you will have a working I2C interface. When the service has restarted, you will have a working I2C interface.

View File

@ -17,7 +17,7 @@ The advantages of using Home Assistant:
- Management web interface integrated into Home Assistant - Management web interface integrated into Home Assistant
- Create and restore full backups of your whole configuration with ease - Create and restore full backups of your whole configuration with ease
- Install many popular add-ons with a single click! For example [Google Assistant], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons &raquo;][all]<br><br> - Install many popular add-ons with a single click! For example [Google Assistant], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons &raquo;][all]<br><br>
- Active community that is helpful and sharing add-ons including AppDaemon, Homebridge and InfluxDB.<br><br>[Browse the forums &raquo;][forums]<br>[Join the Hass.io chat &raquo;][chat]<br>[Browse community add-on repositories &raquo;][comm-add-ons]<br><br> - Active community that is helpful and sharing add-ons including AppDaemon, Homebridge and InfluxDB.<br><br>[Browse the forums &raquo;][forums]<br>[Join the Home Assistant chat &raquo;][chat]<br>[Browse community add-on repositories &raquo;][comm-add-ons]<br><br>
<div class='videoWrapper'> <div class='videoWrapper'>
<iframe width="560" height="315" src="https://www.youtube.com/embed/qnCRcGTznXs" frameborder="0" allowfullscreen></iframe> <iframe width="560" height="315" src="https://www.youtube.com/embed/qnCRcGTznXs" frameborder="0" allowfullscreen></iframe>

View File

@ -82,7 +82,7 @@ Best practice for updating a Home Assistant installation:
SSH to your Home Assistant system, or connect to the console, and run: SSH to your Home Assistant system, or connect to the console, and run:
```bash ```bash
hassio ha update --version=0.XX.X ha core update --version=0.XX.X
``` ```
## Run the beta version on Home Assistant ## Run the beta version on Home Assistant
@ -90,16 +90,17 @@ hassio ha update --version=0.XX.X
If you would like to test next release before anyone else, you can install the beta version released every three weeks: If you would like to test next release before anyone else, you can install the beta version released every three weeks:
1. Backup your installation, using the snapshot functionality Home Assistant offers. 1. Backup your installation, using the snapshot functionality Home Assistant offers.
2. Check the [Home Assistant RC release notes](https://rc.home-assistant.io/latest-release-notes/) for breaking changes. Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f`) and search for **Breaking Changes**. 2. Check the [Home Assistant Beta release notes](https://rc.home-assistant.io/latest-release-notes/) for breaking changes. Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f`) and search for **Breaking Changes**.
3. Select _System_ tab from the _Supervisor_ menu, then select _Join Beta Channel_ under _Supervisor_, then select _Reload_. 3. Select _System_ tab from the _Supervisor_ menu, then select _Join Beta Channel_ under _Supervisor_, then select _Reload_.
4. Select _Dashboard_ tab from the _Supervisor_ menu, and then select _Update_. 4. Select _Dashboard_ tab from the _Supervisor_ menu, and then select _Update_.
## Alternative: install on a generic Linux host ## Alternative: install Home Assistant Supervised on a generic Linux host
For advanced users, it is also possible to try Home Assistant on your [Linux server or inside a virtual machine][linux]. You can also install Home Assistant on a Linux operating system of choice, called Home Assistant Supervised.
Examples given here are tested on Ubuntu and Arch Linux, but the instructions should work as a guideline for installing on other Linux distributions.
The packages you need to have available on your system that will run Home Assistant may vary. Home Assistant Supervised, will still give you access to most features Home Assistant has to offer, including add-ons.
The packages you need to have available on your system needed to Home Assistant may vary.
### Debian/Ubuntu ### Debian/Ubuntu
@ -208,23 +209,23 @@ When you use this installation method, the core SSH add-on may not function corr
A detailed guide about running Home Assistant as a virtual machine is available in the [blog][hassio-vm]. A detailed guide about running Home Assistant as a virtual machine is available in the [blog][hassio-vm].
[balenaEtcher]: https://www.balena.io/etcher [balenaEtcher]: https://www.balena.io/etcher
[Virtual Appliance]: https://github.com/home-assistant/hassos/blob/dev/Documentation/boards/ova.md [Virtual Appliance]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/boards/ova.md
[hassos-network]: https://github.com/home-assistant/hassos/blob/dev/Documentation/network.md [hassos-network]: https://github.com/home-assistant/operating-system/blob/dev/Documentation/network.md
[pi0-w]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi0-w-3.10.img.gz [pi0-w]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi0-w-3.10.img.gz
[pi1]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi-3.10.img.gz [pi1]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi-3.10.img.gz
[pi2]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi2-3.10.img.gz [pi2]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi2-3.10.img.gz
[pi3-32]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi3-3.10.img.gz [pi3-32]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi3-3.10.img.gz
[pi3-64]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi3-64-3.10.img.gz [pi3-64]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi3-64-3.10.img.gz
[pi4-32]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi4-3.10.img.gz [pi4-32]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi4-3.10.img.gz
[pi4-64]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_rpi4-64-3.10.img.gz [pi4-64]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_rpi4-64-3.10.img.gz
[tinker]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_tinker-3.10.img.gz [tinker]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_tinker-3.10.img.gz
[odroid-c2]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_odroid-c2-3.10.img.gz [odroid-c2]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_odroid-c2-3.10.img.gz
[odroid-n2]: https://github.com/home-assistant/hassos/releases/download/4.2/hassos_odroid-n2-4.2.img.gz [odroid-n2]: https://github.com/home-assistant/operating-system/releases/download/4.2/hassos_odroid-n2-4.2.img.gz
[odroid-xu4]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_odroid-xu4-3.10.img.gz [odroid-xu4]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_odroid-xu4-3.10.img.gz
[intel-nuc]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_intel-nuc-3.10.img.gz [intel-nuc]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_intel-nuc-3.10.img.gz
[vmdk]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_ova-3.10.vmdk.gz [vmdk]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_ova-3.10.vmdk.gz
[vhdx]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_ova-3.10.vhdx.gz [vhdx]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_ova-3.10.vhdx.gz
[vdi]: https://github.com/home-assistant/hassos/releases/download/3.10/hassos_ova-3.10.vdi.gz [vdi]: https://github.com/home-assistant/operating-system/releases/download/3.10/hassos_ova-3.10.vdi.gz
[linux]: https://github.com/home-assistant/hassio-installer [linux]: https://github.com/home-assistant/hassio-installer
[local]: http://hassio.local:8123 [local]: http://hassio.local:8123
[samba]: /addons/samba/ [samba]: /addons/samba/

View File

@ -3,7 +3,7 @@ title: "Installing third-party add-ons"
description: "Instructions on how to get started using third-party add-ons." description: "Instructions on how to get started using third-party add-ons."
--- ---
Hass.io allows anyone to create add-on repositories to share their add-ons for Hass.io easily. To try this locally, you can use our example add-on repository at Home Assistant allows anyone to create add-on repositories to share their add-ons easily. To try this locally, you can use our example add-on repository at
```text ```text
https://github.com/home-assistant/hassio-addons-example https://github.com/home-assistant/hassio-addons-example
@ -15,7 +15,7 @@ Home Assistant cannot guarantee the quality or security of third-party add-ons.
<p class='img'> <p class='img'>
<img src='/images/hassio/screenshots/main_panel_addon_store.png' /> <img src='/images/hassio/screenshots/main_panel_addon_store.png' />
From the Hass.io main panel open the add-on store. From the Supervisor main panel open the add-on store.
</p> </p>
<p class='img'> <p class='img'>
@ -25,4 +25,4 @@ Add the URL of the repository and then press "Add". A new card for the repositor
### Help: Repository is not showing up ### Help: Repository is not showing up
If you have added a repository, but it's not showing up, it means that the repository contains invalid configuration. Go to the Hass.io panel and then the System tab to find the System log. It should tell you what went wrong. Report this information to the repository author. If you have added a repository, but it's not showing up, it means that the repository contains invalid configuration. Go to the Supervisor panel and then the System tab to find the System log. It should tell you what went wrong. Report this information to the repository author.

View File

@ -12,7 +12,8 @@ zwave:
## RAZBERRY BOARD ## RAZBERRY BOARD
If you need GPIO on Raspberry Pi 3 for your Z-Wave module, add the following line into `config.txt` (you have to access that on the SD card directly. Simply plug it into your PC and edit it there. The `config.txt` is not accessible from your Hass.io system, you may need to open the SD card on a Windows or Linux system.): If you need GPIO on Raspberry Pi 3 for your Z-Wave module, add the following line into `config.txt` (you have to access that on the SD card directly. Simply plug it into your PC and edit it there.
The `config.txt` is not accessible from the Home Assistant Operating System, you may need to open the SD card on a Windows or Linux system.:
```txt ```txt
dtoverlay=pi3-miniuart-bt dtoverlay=pi3-miniuart-bt
@ -50,13 +51,13 @@ systemctl disable ModemManager.service
### Finding the path ### Finding the path
If the above defaults don't work, you can check what hardware has been found using the [`hassio` command](/hassio/commandline/#hardware): If the above defaults don't work, you can check what hardware has been found using the [`ha` command](/hassio/commandline/#hardware):
```bash ```bash
$ hassio hardware info ha hardware info
``` ```
Or you can use the UI and look in the *System* section of the *Hass.io* menu. There you'll find a *Hardware* button which will list all the hardware found. Or you can use the UI and look in the *System* section of the *Supervisor* menu. There you'll find a *Hardware* button which will list all the hardware found.
## Further reading ## Further reading