Skip to content
Branch: master
Find file History
frenck and pvizeli Fix missing .bash_profile on fresh install, add current path to prompt (

* ssh: Fix for non existing .bash_profile startup error

* ssh: Add current, short, path to command line prompt

* ssh: Bump to 8.1, updated changelog
Latest commit aca8de1 Dec 30, 2019 Core Add-on: SSH server

Allow logging in remotely to using SSH.

Supports aarch64 Architecture Supports amd64 Architecture Supports armhf Architecture Supports armv7 Architecture Supports i386 Architecture


Setting up an SSH server allows access to your folders with any SSH client. It also includes a command-line tool to access the API.

Try it out using:

hassio help


Follow these steps to get the add-on installed on your system:

  1. Navigate in your Home Assistant frontend to -> Add-on Store.
  2. Find the "SSH server" add-on and click it.
  3. Click on the "INSTALL" button.

How to use

To use this add-on, you must have a private/public key to log in. To generate them, follow the instructions for Windows and these for other platforms. It is possible to set a password for login since version 2.0 but for high security use private/public keys.

You can not run both variants at the same time. Enabling login via keys, will disable password login.

  1. Add a ssh key to authorized_keys or set a password in the add-on configuration.
  2. Start the add-on.
  3. Connect to your device using your preferred SSH client and use root as the username.

After logging in, you will find yourself in this add-on’s container. The Home Assistant configuration directory is mounted on the path /config.


Add-on configuration:

  "authorized_keys": [
    "ssh-rsa AKDJD3839...== my-key"
  "password": ""

Option: authorized_keys

Your public keys for the authorized key file. You can authorize multiple keys by adding multiple public keys to the list.

Option: password

Set a password for login. We do NOT recommend this variant.

Known issues and limitations

  • This add-on will not enable you to install packages or do anything as root. This is not working with


Got questions?

You have several options to get them answered:

In case you've found a bug, please open an issue on our GitHub.

You can’t perform that action at this time.