Some additional information (#3882)

About the public key format, how to login and what you'll find once you get there.
This commit is contained in:
Christian Studer 2017-11-03 23:50:12 +01:00 committed by Fabian Affolter
parent 86eee72f82
commit 045c032a61

View File

@ -2,7 +2,7 @@
layout: page layout: page
title: "SSH Server" title: "SSH Server"
description: "Allow logging in remotely to Hass.io using SSH." description: "Allow logging in remotely to Hass.io using SSH."
date: 2017-04-30 13:28 date: 2017-11-03 22:25
sidebar: true sidebar: true
comments: false comments: false
sharing: true sharing: true
@ -22,7 +22,7 @@ This add-on will not enable you to install packages or do anything as root. This
To use this add-on, you must have a private/public key to log in. To generate them, follow the [instructions for Windows][win] and [these for other platforms][other]. 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 variant at same time. To use this add-on, you must have a private/public key to log in. To generate them, follow the [instructions for Windows][win] and [these for other platforms][other]. 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 variant at same time.
In order to start this add-on for the first time, you either need to include an ssh key (enclosed in quotation marks) or set a password in the options section. In order to start this add-on for the first time, you either need to include an ssh key (enclosed in quotation marks, on a single line without line breaks) or set a password in the options section.
```json ```json
{ {
@ -33,11 +33,13 @@ In order to start this add-on for the first time, you either need to include an
} }
``` ```
The username for login over ssh is `root`. The username for login over ssh is `root`. The complete login command is `ssh root@hassio.local`.
After logging in, you will find yourself in this add-ons container. The Home Assistant configuration directory is mounted on the path `/config`.
Configuration variables: Configuration variables:
- **authorized_keys** (*Optional*): Your public-keys for authorized keyfile. Every element will be a line inside that file. - **authorized_keys** (*Optional*): Your public keys for authorized keyfile. Every element will be a line inside that file.
- **password** (*Optional*): Set a password for login. We do not recommend this variant. - **password** (*Optional*): Set a password for login. We do not recommend this variant.