Debugging Hass.io

This section is not for users. Use the SSH add-on to SSH into Hass.io. This is for developers of Hass.io. Do not ask for support if you are using these options.

The following debug tips and tricks are for people who are running the Hass.io image and are working on the base image. If you use the generic Linux installer script, you should be able to access your host and logs as per your host.

SSH access to the host

Create an authorized_keys file containing your public key, and place it in the root of the boot partition of your SD card. Once the device is booted, you can access your device as root over SSH on port 22222.

Windows instructions how to generate and use private/public keys with Putty are here. Instead of the droplet instructions, add the public key as per above instructions.

Alternative instructions, for Mac, Windows and Linux can be found here.

Follow steps 1-4 under ‘Generating a new SSH key’ (The other sections are not applicable to Hass.io and can be ignored.)

Step 3 in the link above, shows the path to the private key file id_rsa for your chosen operating system. Your public key, id_rsa.pub, is saved in the same folder. Next, copy your public key file to the root of your SD card.

Make sure when you are copying the public key to the root of the /boot partition of the SD card that you rename the file correctly with no .pub file extension.

You should then be able to SSH into your Hass.io device. On mac/linux, use:

ssh root@hassio.local -p 22222

Checking the logs

# Logs from the supervisor service on the Host OS
journalctl -f -u resin-supervisor.service

# Hass.io supervisor logs
docker logs hassio_supervisor

# Home Assistant logs
docker logs homeassistant