The Supervisor joins the party

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!

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, 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.

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.

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. 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.

"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. With this system in place, all add-ons and Home Assistant can simultaneously use audio devices and paired Bluetooth-speakers work flawlessly.

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.

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. 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.


This is a companion discussion topic for the original entry at https://www.home-assistant.io/blog/2020/09/16/supervisor-joins-the-party/
16 Likes

Awesome Changes coming! Super excited to use them. A very big thank you for such an amazing work!! Hats off to you guys … Love this!!

Great stuff :slight_smile:

Didn’t know, that you can pair bluetooth speakers with home assistant. But how can this be done?

Wow this month just keeps on giving. Great work guys!

Also :rofl:

3 Likes

Will the new mDNS changes allow a docker install to be configured to not use host networking?

No, and on a docker installation you do not have the supervisor and it’s feature.

Thanks for confirming.

I’m a little confused about the new audo feature, I see I have a device available in the supervisor hardware list:

'1':
    name: HDA-Intel - HDA Intel PCH
    type: PCH
    devices:
      - chan_id: '0'
        chan_type: digital audio playback

How do I expose this to home assistant as a media player so I can connect some powered speakers to the audio jack and throw away my chromecast audio?

I’m sure there are some way of doing that now, the plan is to add that to the supervisor itself and later to the UI.

I’m guessing that would be a ‘ditto’ answer to my question.

Damn, you’ve been working hard. It’s nice to see things like Supervisor explained because it’s very important but not really that visible.

Please warn novice users about static ip though. It’s dangerous and for most people setting a static address in their router is a much safer option.

It’s already exposed to Home Assistant, but you need something to use it, from the top of my head I’m not aware of an integration that uses it, but I might be wrong here.

This?

EDIT: no that requires MPD to be installed somewhere.

You get a warning in the dialog where you can set it, and if you have not set one already it does not show any fields until you change it from “DHCP” to “static”.

Are you also going to support Debian derivates like the most used for HA is Ubuntu 18.04 or 20.04.1?

The 20.04.1 is for getting a SSD to boot on a PI4.

That would be DHCP reservation, not a static address. Those are not the same thing.

3 Likes

No, the Home Assistant project is not supporting that. You can use it though, but it relies on community support.

1 Like

Ah, okay, thanks. It read as if it was already possible.

Let’s not make this another thread about that, it’s been discussed in multiple treads already, and everything is covered in the ADR https://github.com/home-assistant/architecture/blob/3a280053dbd12c80776ba271155a95c9ebb666b2/adr/0014-home-assistant-supervised.md

Let’s keep this thread about the post it self :slight_smile: , and continue to enjoy the celebrations :tada:

7 Likes

Wow, this week is packed with awesome stuff :smiley: I more tempted than ever to move from HA Container to HA Supervised…

1 Like