Add HassOS FAQ (#13927)

Co-authored-by: Sean Mooney <sean.mooney@gmail.com>
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
cogneato 2020-08-03 07:39:07 -06:00 committed by GitHub
parent 7933580f57
commit 4b597ca857
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 66 additions and 5 deletions

View File

@ -1,17 +1,18 @@
<section class="aside-module grid__item one-whole lap-one-half">
<div class='section'>
<div class="section">
<h1 class="title delta">Topics</h1>
<ul class='divided sidebar-menu'>
<ul class="divided sidebar-menu">
<li>
{% active_link /hassio/ Home Assistant %}
<ul>
<li>{% active_link /hassio/installation/ Installation %}</li>
<li>{% active_link /addons/ Available add-ons %}</li>
<li>{% active_link /hassio/installing_third_party_addons/ Installing third-party add-ons %}</li>
<li>{% active_link /hassio/hassos_faq/ Home Assistant OS FAQ %}</li>
</ul>
</li>
</ul>
<ul class='divided sidebar-menu'>
<ul class="divided sidebar-menu">
<li>
Advanced
<ul>
@ -21,8 +22,10 @@
</ul>
</li>
</ul>
<ul class='divided sidebar-menu'>
<li><a href='/developers/hassio/addon_development/'>Looking to create an add-on?</a></li>
<ul class="divided sidebar-menu">
<li>
<a href="/developers/hassio/addon_development/">Looking to create an add-on?</a>
</li>
</ul>
</div>
</section>

View File

@ -0,0 +1,58 @@
---
title: "Home Assistant OS FAQ"
description: "Frequently Asked Questions for Home Assistant OS"
---
## Is USB Boot for the Pi4 supported? Is the Pi4 with 8GB RAM supported?
The bootloader for Home Assistant OS (uboot) does not yet support Pi4 booting from USB. Support is likely a month or two away as of July 2020.
The Pi4, with 8GB RAM, is similarly waiting for support from upstream.
## How do I run a specific version of Home Assistant?
For this you would need to install the [Terminal & SSH add-on][ssh] or use the console
that is available on your device by connecting a keyboard and screen.
To install the Terminal & SSH add-on, choose **Supervisor**, which is located in the sidebar and then the add-on store. If you don't see it, enable "Advanced Mode" from your profile page.
Use the web-based terminal or SSH to your Home Assistant system, or connect to the console, and run:
```bash
ha core update --version=0.XX.X
```
Replace 0.XX.X with the version you want. e.g., `0.111.2`
You can also use a similar command for the operating system:
```bash
ha os update --version 4.11
```
## Do I need to leave the USB stick connected for Wi-Fi?
No. The USB "CONFIG" stick is only used to import a network profile to `/etc/NetworkManager/system-connections/` and can be removed.
## 404 Client Error: Not Found ("no such image: homeassistant/...)
This error indicates the image, whether for updating to Home Assistant or installing or updating an add-on, was not able to be pulled to your system. This is usually a situation where there is not enough space for the image to be downloaded. The first thing to check for is the available space on your system.
Please note, if you are running the operating system as a virtual machine; the default VM image is only about 6GB. Many VM users run into this as they have not allocated enough storage. 32 GB is the minimum recommended size.
You'll need to explore your own system to determine where space has gone.
Using `df -h` in the SSH add-on console to you can quickly check to see if you have space available.
If there is plenty of space available then you might check to see if you are having network issues that are preventing images being downloaded.
## Why does the start button for an add-on flash red when I click it?
If you are looking for more information about add-ons, which won't start or install, navigate to Supervisor > System in the UI and check the logs.
The logs on this page are the same you would see using `ha logs` in the custom CLI.
## I'm trying to find my files on the host or SD card. Where are they?
On a Home Assistant OS install, your files are on the data partition within `/mnt/data/supervisor/`.
On the SD itself, this is an EXT4 partition labeled `hassos-data`
On a Supervised install, they are in `/usr/share/hassio/`.