Hassio_FAQ.md

Hassio FAQ

Frequently asked questions from the Discord channel

This first one isn't a question, but a strong recommendation:

INSTALL ONE OF THE SSH ADDONS

Do it! Do it now! Pick one from either the official repo or the community repo (recommended) and install it, set up a user/pass or key, and then forget about it if you want. But leave it running and set to run at startup.

I run in a VM and already have SSH access. Why would I need to do that?

The ssh addons provide access to the Hassio custom CLI which includes the proper method of starting and stopping Home Assistant, in addition to ways to explore and manipulate snapshots, addons, check logs and move from one version to another. This is extremely useful when you lose the UI due to a misconfiguration, or even when you have stopped the Home Assistant server from within the UI. You will be glad you have the custom CLI when you need it.

How do I downgrade to another version?

From the ssh addon console (hey that ssh addon is useful already!) use: hassio ha up --version=0.x.y

Replace 0.x.y with the version you want. e.g. 0.74.1

You can go forward or backward with this command.

You can also use a similar command for the supervisor: hassio su up --version=119

How do I setup wifi for HassOS?

You can configure multiple network profiles, including ethernet, wifi, and static ip address using a case sensitive CONFIG directory which you create on the boot partition or a temporary USB drive. https://github.com/home-assistant/operating-system/blob/dev/Documentation/configuration.md

Home Assistant OS uses network manager. If you have tried importing network keyfiles and keep failing, I have another guide here for a more "hands-on" method which requires installing a specific addon and using nmcli: https://gist.github.com/cogneato/88ef36646cdcedaca9a4e3ee8ffbd5c2

Why do I get this error when trying to update or install an addon?

ERROR (SyncWorker_11) [hassio.docker.interface] Can't install homeassistant/raspberrypi2-homeassistant:0.74.2 -> 404 Client Error: Not Found ("no such image: homeassistant/raspberrypi2-homeassistant:0.74.2: No such image: homeassistant/raspberrypi2-homeassistant:0.74.2")

This is usually a matter of not having enough space for the image to be downloaded.

You'll need to explore your own system to determine where the space has gone. Some helpful commands to use in the ssh addon console to help investigate are:

df -h

This is a quick way to check on the space available on your disk.

ls -hal /config This will show you the contents of /config along with file sizes. Look for anything large. Other directories you might check are /share or /backup.

Why do I get this error from DuckDNS / LetsEncrypt?

ERROR: Problem connecting to server (get for https://acme-v02.api.letsencrypt.org/directory; curl returned with 6)

This is a Docker DNS issue which often happens with Ubuntu 18.04 installs, but can happen in other cases.

Open a terminal on your linux machine or VM and use echo '{"dns": ["8.8.8.8", "8.8.4.4"]}' > /etc/docker/daemon.json

More info here: https://development.robinwinslow.uk/2016/06/23/fix-docker-networking-dns/

Why won't this addon install? or Why does the start button flash red when I click it?

If you are looking for more information about addons, go to hass.io > system in the UI and check the logs.

The logs on this page are the same you would see using hassio su logs in the custom cli.

I'm trying to find my files on the host or SD card. Where are they?

on a HassOS install: /mnt/data/supervisor/

on a generic linux install like Ubuntu, etc: /usr/share/hassio

Where are the USB network files imported to on the host?

/etc/NetworkManager/system-connections

Where is the authorized_keys file imported to on the host?

/root/.ssh