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
resinOS based Hass.io (deprecated)
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.
HassOS based Hass.io
Use a USB drive formatted with FAT, ext4, or NTFS and name it CONFIG (case sensitive). Create an
authorized_keys file containing your public key, and place it in the root of the USB drive. From the UI, navigate to the hass.io system page and choose "Import from USB". You can now access your device as root over SSH on port 22222. Alternatively, the file will be imported from the USB when the hass.io device is rebooted.
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, select all text from text box "Public key for pasting into OpenSSH authorized_keys file" and save it to the root of your SD card as
Make sure when you are copying the public key to the root of the /resin-boot partition of the SD card that you rename the file correctly to
You should then be able to SSH into your Hass.io device. On mac/linux, use:
ssh [email protected].local -p 22222
Checking the logs
# Logs from the supervisor service on the Host OS journalctl -f -u hassos-supervisor.service # Hass.io supervisor logs docker logs hassos_supervisor # Home Assistant logs docker logs homeassistant