diff --git a/source/_docs/configuration/troubleshooting.markdown b/source/_docs/configuration/troubleshooting.markdown index d7e1132c183..31061131b8c 100644 --- a/source/_docs/configuration/troubleshooting.markdown +++ b/source/_docs/configuration/troubleshooting.markdown @@ -20,7 +20,7 @@ If you have incorrect entries in your configuration files you can use the config One of the most common problems with Home Assistant is an invalid `configuration.yaml` or other configuration file. -- With Home Assistant you can use the [`ha` command](/hassio/commandline/#home-assistant): `ha core check`. +- With Home Assistant OS and Supervised you can use the [`ha` command](/hassio/commandline/#home-assistant): `ha core check`. - You can test your configuration with Home Assistant Core using the command line with: `hass --script check_config`. If you need to provide the path for your configuration you can do this using the `-c` argument like this: `hass --script check_config -c /path/to/your/config/dir`. - 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. diff --git a/source/_integrations/google_pubsub.markdown b/source/_integrations/google_pubsub.markdown index 35431fc696e..9fa3a821c12 100644 --- a/source/_integrations/google_pubsub.markdown +++ b/source/_integrations/google_pubsub.markdown @@ -13,16 +13,15 @@ The `google_pubsub` integration allows you to hook into the Home Assistant event This assumes you already have a Google Cloud project. If you don't, please create one in the [Google Cloud Console](https://console.cloud.google.com/projectcreate) -You need to create a Service Account key in the [Google Cloud API Console](https://console.cloud.google.com/apis/credentials/serviceaccountkey) +Create a Google Pub/Sub topic in the [Google Cloud API Console](https://console.cloud.google.com/cloudpubsub/topicList). The topic name will become something like `projects/project-198373/topics/topic-name`. Note the last part only (the name you chose): `topic-name`. + +Next, you need to create a Service Account key in the [Google Cloud API Console](https://console.cloud.google.com/apis/credentials/serviceaccountkey) - Choose a new "New Service Account", give it a name and leave the key type as JSON - Select the role: Pub/Sub Publisher This will download the Service Account JSON key to your machine. Do NOT share this with anyone. Place this file in your Home Assistant configuration folder. -Next, create a Google Pub/Sub topic in the [Google Cloud API Console](https://console.cloud.google.com/cloudpubsub/topicList). The topic name will become something like `projects/project-198373/topics/topic-name`. Note the last part only (the name you chose): `topic-name`. - - ## Configuration Add the following lines to your `configuration.yaml` file: diff --git a/source/_posts/2020-09-15-home-assistant-tags.markdown b/source/_posts/2020-09-15-home-assistant-tags.markdown index c70bacde9e8..e69069d4f95 100644 --- a/source/_posts/2020-09-15-home-assistant-tags.markdown +++ b/source/_posts/2020-09-15-home-assistant-tags.markdown @@ -52,7 +52,7 @@ Because it's powered by ESPHome, setting up is a breeze. Once powered on, it wil The nice thing about standalone tag readers is that they are dedicated to a room. This means automations know in which room to act when a music card is scanned and can pick the right media player. This makes it easy to have cards that can work in every room. -The tag reader is open-source and [available on GitHub](https://github.com/adonno/tagreader). You can make one yourself or buy one of the pre-built ones or DIY kits that Adonno is [selling](https://adonno.com/product/tag-reader/). +The tag reader is open-source and [available on GitHub](https://github.com/adonno/tagreader). You can make one yourself or buy one of the pre-built ones or DIY kits that Adonno is [selling](https://adonno-crafts.myshopify.com/). ## Managing Tags in Home Assistant 0.115 diff --git a/source/_posts/2020-09-16-supervisor-joins-the-party.markdown b/source/_posts/2020-09-16-supervisor-joins-the-party.markdown new file mode 100644 index 00000000000..2478c9ef7ce --- /dev/null +++ b/source/_posts/2020-09-16-supervisor-joins-the-party.markdown @@ -0,0 +1,103 @@ +--- +title: "The Supervisor joins the party" +description: "In celebration of the 7th anniversary of Home Assistant, we’ve got some Supervisor updates to show you." +date: 2020-09-16 00:00:00 +date_formatted: "September 16, 2020" +comments: true +author: Joakim Sørensen +author_twitter: ludeeus +categories: Announcements +og_image: /images/blog/2020-09-16-supervisor-joins-the-party/social.png +--- + +The Supervisor is responsible for managing your system so that you can manage your home. It’s the beating heart of the Home Assistant Operating System and it ensures that your system stays secure and up to date. When things do go wrong, the Supervisor is there to help you recover the system. + +Earlier this year, we limited the scope of what systems we support with the Supervisor. This has given us the opportunity to invest more time and resources into stability, usability improvements and new features. + +## Crash Reporting + +The Supervisor can now share anonymized diagnostics and crash information with the Home Assistant developers that work on the Supervisor. This option is, of course, opt-in and disabled by default. With this enabled, you submit issues without needing to open an issue! + +![diagnostics graphic](/images/blog/2020-09-16-supervisor-joins-the-party/diagnostics.png) + +Since we introduced this feature, over 25,000 events have been sent, generating around 120 unique issues. We have already fixed over 80 issues! With each release, fixes have been made as a result of these reports, making the Supervisor even more stable; This really shows how powerful it is. + +Big thanks to [Sentry][sentry], for powering and sponsoring this great feature. + +
+ "Accurate information is a key part of motivation." - Mary Ann Allison +
+ +## Improve add-on availability with the new watchdog feature + +Add-ons for Home Assistant allow you to run third-party applications easily. These applications will benefit from the same management features also used to manage your Home Assistant installation. + +Add-on developers will be able to activate additional functionality for their add-on with the new “watchdog” add-on option. This enables application-level monitoring and allows the Supervisor to check if the add-on is behaving correctly using the ways specified by the developer. + +Not all add-ons have this feature and an add-on can still get themselves into problems that they can’t recover from, causing the application not to work as expected and crash. For this purpose, we have introduced a new watchdog toggle for advanced users. The functionality is similar to Docker’s health checks but operates outside of the container, making it a more robust option. + +![watchdog graphic](/images/blog/2020-09-16-supervisor-joins-the-party/watchdog.png) + +When the watchdog is enabled for an add-on, the Supervisor will automatically restart the add-on if it stops, regardless of the reason (crash/manual stop). The watchdog does not know if you’re testing an add-on or playing around with different options, and so it might restart when you don’t need it. You should only enable the watchdog after you are finished setting the add-on up and want to make sure it’s running 24/7. + +
+ "Never stop never stopping." - Conner4Real +
+ +## Network Manager + +The most requested feature is here! You can now manage the network settings from the Supervisor interface. Previously you would have to fiddle with “nmcli” or go through the tedious act of importing configuration files from USB-sticks just to set a static IP address for your Home Assistant installation. With the introduction of the Supervisor’s Network Manager this can now be handled from the Supervisor panel in your Home Assistant UI. You will find this under the system tab. + +![dialog graphic](/images/blog/2020-09-16-supervisor-joins-the-party/dialog.png) + +This is just the start to make advanced host management more accessible and it only touches a minimal part of what we will be able to do with it. Support for Wi-Fi and Bluetooth will follow later as part of our usability improvements. + +
+ "OMG. Finally." - @cogneato +
+ +## Observer Plugin + +The Supervisor provides several other services using “plugins”. Plugins are microservices that add features to help run Home Assistant + add-ons and manage your system. The latest plugin added is the [Observer plugin][observer]. The observer keeps an eye on the Supervisor. It provides a diagnostics portal on port `4357`(HELP). In case you ever lose access to the Supervisor, you can go to the Observer Portal to get the Supervisor status and logs and diagnose what’s wrong (and share it with us). The benefit of having this as a web portal is that you no longer need to attach a monitor and keyboard to your device or know the Linux commands to get the information out. + +This is the first version and will be extended with more information and functionality in the future. + +![observer graphic](/images/blog/2020-09-16-supervisor-joins-the-party/observer.png) + +
+ "Better to have, and not need, than to need, and not have." - Franz Kafka +
+ +## Improved Audio + +Early this year, we built a new Audio layer with a central sound server based on [PulseAudio][pulseaudio]. With this system in place, all add-ons and Home Assistant can simultaneously use audio devices and paired Bluetooth-speakers work flawlessly. + +![audio graphic](/images/blog/2020-09-16-supervisor-joins-the-party/audio.png) + +We will be working on exposing more of these features via the UI in the future, such as controlling the audio volume. The command-line interface supports most of the functionality already and is accessible via the SSH & Web Terminal add-on and entering `ha audio --help`. + +

+ Screenshot of Spotify connected to Home Assistant as audio output. + The Spotify Connect add-on from Community Add-Ons allows playing Spotify via Home Assistant +

+ +## Improved mDNS + +Hostnames on your network often end with `.local`, for example, `http://homeassistant.local:8123`. This is a feature called mDNS. With Home Assistant OS and Supervised systems, this hasn’t always been functioning as well as it should have. This is a side effect caused by using the Docker layers to power the systems. + +Last year we introduced a new DNS backend based on [CoreDNS][coredns]. This year, we’ve extended our DNS plugin with mDNS support and are forwarding all multicast traffic from mDNS onto the Supervisor’s internal network. + +This means we now have support for `.local` domains everywhere and it is transparent throughout the whole system, including Home Assistant and all add-ons. + +
+ "It’s not DNS. There’s no way it’s DNS. It was DNS. - anonymous +
+ +## That’s it! + +There have been a lot of updates to the Supervisor. In the end, we hope that you don’t notice any of them. Because if the Supervisor does it’s job, you’re just automating your home without worrying about maintenance of your system. + +[coredns]: https://coredns.io/ +[observer]: https://github.com/home-assistant/plugin-observer +[sentry]: http://sentry.io/ +[pulseaudio]: https://www.freedesktop.org/wiki/Software/PulseAudio/About/ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/audio.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/audio.png new file mode 100644 index 00000000000..11fb7a68f1a Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/audio.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/diagnostics.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/diagnostics.png new file mode 100644 index 00000000000..669c1344189 Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/diagnostics.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/dialog.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/dialog.png new file mode 100644 index 00000000000..0d0578e07ec Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/dialog.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/observer.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/observer.png new file mode 100644 index 00000000000..ffbaeeca2cd Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/observer.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/social.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/social.png new file mode 100644 index 00000000000..08b57638ee6 Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/social.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/spotify.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/spotify.png new file mode 100644 index 00000000000..a5c85036df5 Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/spotify.png differ diff --git a/source/images/blog/2020-09-16-supervisor-joins-the-party/watchdog.png b/source/images/blog/2020-09-16-supervisor-joins-the-party/watchdog.png new file mode 100644 index 00000000000..6546d3d295f Binary files /dev/null and b/source/images/blog/2020-09-16-supervisor-joins-the-party/watchdog.png differ