You are running an unsupported installation - what does it mean?

smoltron · October 27, 2021, 6:54pm

After the last update Home Assistant supervisor says that I am running an unsupported installation. I have a powerful Debian server which I am using for some other tasks as well. I can support myself, that is not a problem.
It is not however clear to me, what does this unsupported mean. Does it mean that I do not get any updates any more? That worries me. Can someone clarify?

123 · October 27, 2021, 7:50pm

What does it say when you click Learn More?

Screenshot from 2021-10-27 15-49-20

If it says “Unhealthy” then you will be blocked from upgrading Home Assistant and upgrading any Add-ons you may have.

“Unsupported” means your system is doing something that deviates from the standards defined by the development team. See ADR-0014.

github.com

home-assistant/architecture/blob/713f61010b11edf52e543d28be2fc7c47b5dc072/adr/0014-home-assistant-supervised.md

# 0014. Installation method: Home Assistant Supervised

Date: 2020-06-03

## Status

Accepted

## Context

Define a supported installation method as per [ADR-0012](https://github.com/home-assistant/architecture/blob/master/adr/0012-define-supported-installation-method.md).

## Decision

This installation method provides the full Home Assistant experience on a regular operating system. This means, all components from the Home Assistant method are used, except for the Home Assistant Operating System. This system will run the Home Assistant Supervisor. The Supervisor is not just an application, it is a full appliance that manages the whole system. It will clean up, repair or reset settings to default if they no longer match expected values.

By not using the Home Assistant Operating System, the user is responsible for making sure that all required components are installed and maintained. Required components and their versions will change over time. Home Assistant Supervised is provided as-is as a foundation for community supported do-it-yourself solutions. We only accept bug reports for issues that have been reproduced on a freshly installed, fully updated Debian with no additional packages.

This method is considered advanced and should only be used if one is an expert in managing a Linux operating system, Docker and networking.

This file has been truncated. show original

maxym · October 27, 2021, 8:36pm

AFAIK recently all HA with older HAOS lower than 6 turned unsupported. It’s because of missing some component (OS agent?). probably it can be added manually

edit: I found it: Supervisor update - #14 by pvizeli

Prodigyplace · October 27, 2021, 8:39pm

HA Supervised is ONLY supported on a vanilla Debian installation, either the STABLE or OLDSTABLE version. Perhaps it detected some additional packages installed.

francisp · October 28, 2021, 3:59am

Buster not long anymore. There was only 4 months deprecation time. It says ‘unsupported’ if you have any non-HA docker installed.

smoltron · October 28, 2021, 5:23am

The error message says “Unsupported software detected”. I am running a Debian installation of Influxdb, Grafana and Dokuwiki. I do not wish to install them from unknown containers maintained by a 3rd party. I prefer using official sources. My Debian is Bullseye.

I still want to know what “unsupported” means. Do I miss security updates now?

smoltron · October 28, 2021, 6:26am

I found the “Unsupported software”. It was Portainer, that I had installed for some reason. I removed the container and now there is no complaint any more. Still, it would be good to know the exact meaning of “unsupported”. Is it just a warning or are there concrete implications.

francisp · October 28, 2021, 6:30am

If it is bare metal, Supervisor does not detect it yet.

Only if supervisor says ‘unhealthy’

If you have a problem, you can’t file an issue on GitHub. The devs will close it immediately.

k8gg · October 28, 2021, 1:01pm

Hmmm… I think have a head scratcher here:

Yes I clicked the link. Yes I read the ADR-0014. But then I’m on the latest (?) HAOS 6.5, which is a VM…
Where else could I check? Any specific log or error messages I should be outlook for? Any thing I can do from the CLI?

(Don’t know how long it has been that way either.)

In my supervisor log, everything is green except for 4 yellow warning lines about AdGuard Home and UniFi Controller because of the recent snapshot vs backup change. Would that make supervisor deem my system unsupported? No other red line.

francisp · October 28, 2021, 1:02pm

What did the ‘learn more’ link say ?

k8gg · October 28, 2021, 1:10pm

Clicking the “learn more”:

And then the “Unsupported software detected” link leads me to Unsupported software - Home Assistant (home-assistant.io)

… which further leads to ADR-0014.

I mean, I don’t even know how one could manually install anything (that is not an add-on) in HAOS.

francisp · October 28, 2021, 1:25pm

Did you add an extra docker container using portainer ?

‘Unsupported software detected’ really means ‘Non HA docker container detected’

k8gg · October 28, 2021, 1:45pm

Is that what this is about? I mean, they could have just said so in the documents / descriptions.

If anything, that would be long time ago, as I couldn’t recall anything at the moment.
I will check. Thanks for the pointer.

123 · October 28, 2021, 2:29pm

I’m curious to know, which part of the first reply in this thread failed to answer your first question (and its duplicates)?

smoltron · October 28, 2021, 5:32pm

Thank you. You did not actually say what unsupported meant for the user. At least I did not understand it - so it is probably because of my own limitations.

123 · October 28, 2021, 6:20pm

Because, like I stated, only “Unhealthy” imposes noticeable operational constraints for the user.

If it only indicates “Unsupported” then, unlike "Unhealthy, it imposes no noticeable constraints other than what the word literally means (un-supported = no support).

Anyway, glad to hear you now understand what it means.

If you want to use Portainer, you can install it as an Add-on from the Add-on Store. It’s maintained by Frenck who is a member of Home Assistant development team (also an employee of NabuCasa).

FYI: Another docker container that Supervisor dislikes is watchtower.

maxym · November 4, 2021, 7:23pm

There are several different “unsupported” messages.
Unsupported software detected
You are running an unsupported installation
curious about more

But as I mentioned already “unsupported installation” might mean lack of OS agent (or simply hass os older than v6.

I cannot believe github issues are being closed immediately based on supervisor status, even if an issue is not connected to operating system version

Sweetpants · July 22, 2022, 6:42am

I’m having the same message “unsupported installation”

I followed the instructions in the supplied link Docker Configuration - Home Assistant , but still receive the same message over and over again.

I’m running HA 2022.7.6 Supervised 2022.7.0 on Debian 11 (bullseye) with only HA add-ons

Anybody knows what is going on here? The system is running fine though so why is it still unsupported?

eevans · November 13, 2022, 7:16pm

I realize this is an old thread, but I’m in the process of changing home servers and haven’t messed with my setup in a while.

My current home server is an OMV 5 setup with docker that runs about 30 containers. I’m able to run Home Assistant Supervised with this setup. The HA core version is 2021.11.0. The supervised version is 2022.10.0. I realize it’s an older Core version but I’m not experiencing any issues with my current setup so I’m not updating it right now.

The new server I’m setting up is an OMV 6 setup with docker. I’ve followed the steps on GitHub - home-assistant/supervised-installer: Installer for a generic Linux system. (I did the same with my current server) It seems to work, but I have the “error” of ‘unsupported software’ and ‘unhealthy system - docker misconfigured’. I only have Portainer running at the moment.

What’s changed between what’s on my current server to the new one?

I don’t understand why we would be able to have the ability to install Supervised in a docker setup, but not be able to run other containers along side it.

I don’t want to run Portainer/Docker from HA. That is completely ridiculous since I already have Docker outside of HA.

What are my options?

eevans · November 13, 2022, 8:04pm

Nevermind. I found the “solution” here - 'HomeAssistantCore.update' blocked from execution, system is not healthy - #143 by jonasbuhlkristiansen

I ran this code on my server. Not ideal, but it’ll work…until it’s not supported either.

 ha jobs options --ignore-conditions healthy