WTH is there so little documentation about the architecture of supervised HA

I recently posted a question elsewhere about deploying a new HA image, and it not working at all.

I am willing and able to do some troubleshooting, but there is minimal information in the user- or developer documentation about the operation of hassos, the supervisor and the containerized version of HA.

What software is running to create the strange HA prompt when you log in to the console? How does it interact with hassos and HA? Where do I look to check what is working and what not? Where are the logs stored? What is the normal startup sequence and where are the startup scripts located?

I know that documentation is a chore to write, but having absolutely none is disappointing. If the developers could only throw us a small bone to show us the basic operation and architecture of the supervised system, that would be a huge help in debugging “nothing works” issues.

https://github.com/home-assistant/operating-system

https://github.com/home-assistant/operating-system/tree/dev/Documentation#developer-documentation

Thank you, appreciate the links. Even there though, the developer documentation is very, very sparse and does not really contain enough info for troubleshooting.

You also have the main HassOS architect on tap to answer your questions:

General enquiries:


Development based questions:

Thank you! The folks over there were able to help me solve the issue in short order.

Are there updated links for these discord servers? These ones don’t seem to work anymore? Never been on discord so maybe it’s me.

Is there a separate discord for discussing core beta releases? Or is there another place where beta versions are discussed? I’m assuming it’s not here on the forums, I never really see any discussion about betas on here. Just ran into a big issue with the latest beta release, I’d like to get on top of it.

Edit. I managed to get on the main Home Assistant one via discord search.
Edit 2. And I found the beta one also on the FAQ.