diff --git a/_config.yml b/_config.yml index 172ba688925..1ae1d2ad2bb 100644 --- a/_config.yml +++ b/_config.yml @@ -101,8 +101,8 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 109 -current_patch_version: 3 -date_released: 2020-05-02 +current_patch_version: 4 +date_released: 2020-05-04 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown index f62ea7a62ab..81ae30d9e97 100644 --- a/source/_docs/authentication.markdown +++ b/source/_docs/authentication.markdown @@ -95,7 +95,8 @@ You have to use a domain name, not IP address, to remote access Home Assistant o This is because we only allow an IP address as a client ID when your IP address is an internal network address (e.g., `192.168.0.1`) or loopback address (e.g., `127.0.0.1`). -If you don't have a valid domain name for your Home Assistant instance, you can modify the `hosts` file on your computer to fake one. On Windows, edit the `C:\Windows\System32\Drivers\etc\hosts` file with administrator privilege, or on Linux the `/etc/hosts` file, and add following entry: +If you don't have a valid domain name for your Home Assistant instance, you can modify the `hosts` file on your computer to fake one. +On Linux edit the `/etc/hosts` file, and add following entry: ```text 12.34.56.78 homeassistant.home diff --git a/source/_docs/configuration.markdown b/source/_docs/configuration.markdown index aa496c85f4b..afe48dbf883 100644 --- a/source/_docs/configuration.markdown +++ b/source/_docs/configuration.markdown @@ -15,7 +15,6 @@ The location of the folder differs between operating systems: | Docker | `/config` | | macOS | `~/.homeassistant` | | Linux | `~/.homeassistant` | -| Windows | `%APPDATA%/.homeassistant` | If you want to use a different folder for configuration, use the configuration command line parameter: `hass --config path/to/config`. diff --git a/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown b/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown index 7926fedadcb..90d4701308b 100644 --- a/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown +++ b/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown @@ -50,6 +50,14 @@ http: ssl_key: /home/your_user/.homeassistant/privkey.pem ``` +Docker: + +```yaml +http: + ssl_certificate: /config/fullchain.pem + ssl_key: /config/privkey.pem +``` + 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: diff --git a/source/_docs/installation/python.markdown b/source/_docs/installation/python.markdown index 367cf4e6d0f..8e1e16f1158 100644 --- a/source/_docs/installation/python.markdown +++ b/source/_docs/installation/python.markdown @@ -19,13 +19,12 @@ hass --open-ui Running these commands will: - - Install Home Assistant - - Launch Home Assistant and serve the web interface on [http://localhost:8123](http://localhost:8123) +- Install Home Assistant +- Launch Home Assistant and serve the web interface on [http://localhost:8123](http://localhost:8123) Video tutorials of this process for various operating systems are available here: - - [Windows 10](https://www.youtube.com/watch?v=X27eVvuqwnY) - - [macOS](https://www.youtube.com/watch?v=hej6ipN86ls) - - [Ubuntu 14.04](https://www.youtube.com/watch?v=SXaAG1lGNH0) +- [macOS](https://www.youtube.com/watch?v=hej6ipN86ls) +- [Ubuntu 14.04](https://www.youtube.com/watch?v=SXaAG1lGNH0) Keep in mind that the operating systems used and the software releases shown may be outdated. diff --git a/source/_integrations/discovery.markdown b/source/_integrations/discovery.markdown index b2b625f3344..9fccca2824c 100644 --- a/source/_integrations/discovery.markdown +++ b/source/_integrations/discovery.markdown @@ -99,9 +99,19 @@ Valid values for enable are: ### mDNS and UPnP -Home Assistant must be on the same network as the devices for UPnP discovery to work. +Home Assistant should be on the same network as the devices for mDNS and UPnP discovery to work. + When running Home Assistant Core in a [Docker container](/docs/installation/docker/) command line option `--net=host` or the compose file equivalent `network_mode: host` must be used to put it on the host's network, otherwise mDNS and UPnP will not work. +If mDNS is still not working: +- Make sure there are no firewall rules blocking mDNS traffic. mDNS relies on sending and receiving UDP multicast packets on port 5353. +- mDNS traffic may not be forwarded correctly between the wired and wireless interfaces of a Wi-Fi AP or router. + +#### mDNS forwarding +If it's not possible to have Home Assistant and the devices on the same network, mDNS forwarding may allow mDNS discovery between networks. + +mDNS forwarding is a configurable option in some routers. It can also be called mDNS reflector or mDNS repeater, depending on the manufacturer. + ### Windows #### 64-bit Python diff --git a/source/_integrations/ffmpeg.markdown b/source/_integrations/ffmpeg.markdown index a2f69d7165e..1aa89f6c6a3 100644 --- a/source/_integrations/ffmpeg.markdown +++ b/source/_integrations/ffmpeg.markdown @@ -12,7 +12,8 @@ The `ffmpeg` integration allows other Home Assistant integrations to process vid
- Add-ons for Hass.io are freely available in the add-on store.
+ Add-ons for Home Assistant are freely available in the add-on store.
To install add-ons, navigate to the Supervisor panel in your Home Assistant frontend, and click on the "ADD-ON STORE" tab. All add-ons, including their documentation, are available right from the store. + Some advanced add-ons will only be visible after you opt-in to "Advanced Mode" which can be changed on your user profile page. Click on a add-on you are interested in, to read the documentation or to install the add-on.
diff --git a/source/help/reporting_issues.markdown b/source/help/reporting_issues.markdown index 6dac514943c..893ea9db372 100644 --- a/source/help/reporting_issues.markdown +++ b/source/help/reporting_issues.markdown @@ -4,33 +4,27 @@ description: "Reporting issues about Home Assistant" sidebar: false --- -If you have an installation, a setup or a configuration issue please use our [Forum](https://community.home-assistant.io/) to get help. We have a big community which will help you if they can. +If you have an installation, a setup or a configuration issue please use our [Forum](https://community.home-assistant.io/) to get help. We have a big community which will help you if they can. -If you found a bug then please report it in one of our [trackers](/help/#bugs-feature-requests-and-alike). To help you and our developers to identify the issue quickly, please fill out the provided template. The "weird" content you will see is there to render your entry in a nice format after submitting. It's just [markdown](https://guides.github.com/features/mastering-markdown/). +If you found a bug then please report it in one of our [trackers](/help/#bugs-feature-requests-and-alike). To help you and our developers to identify the issue quickly, please fill out the provided template. The "weird" content you will see is there to render your entry in a nice format after submitting. It's just [markdown](https://guides.github.com/features/mastering-markdown/). -Use the command below to get the Home Assistant release you are running from a command-line. +Please refer to the **Info** page, which is accessible in the **Developer tools** in the Home Assistant frontend. -```bash -$ hass --version -``` - -Otherwise check the **About** page which is accessible in the **Developer tools** of the Home Assistant frontend. - -### First Home Assistant release with the issue +## First Home Assistant release with the issue Please provide the release which contains the issue. -### Last working Home Assistant release (if known) +## Last working Home Assistant release (if known) If possible, provide the latest release of which you know that the integration or platform was working. Home Assistant is evolving very fast and issues may already be addressed or be introduced by a recent change. -### Operating environment (Hass.io/Docker/Windows/etc.) +## Operating environment -There are many different ways to run Home Assistant. In this section please mention which you are using, e.g., manual installation, [Hass.io](/hassio/), Hasbian or as container (Docker). It can help if you mention which operating system you are using because not all are supported on the same level. +There are many different ways to run Home Assistant. In this section please mention which you are using, e.g., Home Assistant (using the Home Assistant Operating System), Home Assistant Supervised, Home Assistant Core in Docker or a manual installation of the Home Assistant Core. It can help if you mention which operating system you are using because not all are supported on the same level. -### Integration/platform +## Integration -Please add the link to the documention of the integration/platform in question. E.g., +Please add the link to the documentation of the integration in question. E.g., - issue with the `random` sensor: [/integrations/random#sensor](/integrations/random#sensor) - issue with the `hue` integration: [/integrations/hue/](/integrations/hue/) @@ -43,7 +37,7 @@ There are integrations and platform which require additional steps (installing t ### Problem-relevant `configuration.yaml` entries -To exclude configuration issues and allow the developers to quickly test, and perhaps reproduce, your issue, add the relevant part of your `configuration.yaml` file. This file is located in your [configuration folder](/docs/configuration/). +To exclude configuration issues and allow the developers to quickly test, and perhaps reproduce, your issue, add the relevant part of your `configuration.yaml` file. This file is located in your [configuration folder](/docs/configuration/). ```yaml sensor: @@ -64,4 +58,3 @@ Traceback (most recent call last): ### Additional information This section can contain additional details or other observation. Often the little things can help as well. - diff --git a/source/lovelace/actions.markdown b/source/lovelace/actions.markdown index 7d49c9e912e..fafba26b913 100644 --- a/source/lovelace/actions.markdown +++ b/source/lovelace/actions.markdown @@ -7,9 +7,10 @@ Some Lovelace cards have support for tap actions. These actions define what will Actions can be enabled on: -- [Entity](/lovelace/entities/) -- [Entity Button](/lovelace/entity-button/) +- [Button](/lovelace/button/) +- [Entities](/lovelace/entities/) - [Glance](/lovelace/glance/) +- [Light](/lovelace/light/) - [Picture](/lovelace/picture/) - [Picture Element](/lovelace/picture-elements/) - [Picture Entity](/lovelace/picture-entity/) diff --git a/source/lovelace/index.markdown b/source/lovelace/index.markdown index 623fcd687c1..43981cc24cb 100644 --- a/source/lovelace/index.markdown +++ b/source/lovelace/index.markdown @@ -7,7 +7,7 @@ redirect_from: Lovelace is the Home Assistant user interface. It's a fast, customizable and powerful way for users to manage their homes, working on mobile or desktop. -- 24 different cards to place and configure as you like. +- 25 different cards to place and configure as you like. - UI Editor. A configuration UI to manage your Lovelace UI including live preview when editing cards. - Fast. Using a static configuration allows us to build up the UI once. - Customizable. @@ -26,7 +26,7 @@ To try it yourself, check out [the demo](https://demo.home-assistant.io). ## Discuss Lovelace -- Suggestions are welcome in the [home-assistant-polymer repository](https://github.com/home-assistant/home-assistant-polymer/) +- Suggestions are welcome in the [frontend repository](https://github.com/home-assistant/frontend/) - For help with Lovelace, join the `#frontend` channel on [our chat](/join-chat/) or [our forums](https://community.home-assistant.io/c/projects/frontend) ## Additional Lovelace Resources