home-assistant.github.io/source/_addons/ssh.markdown
ciotlosm 52ab99289d Use sshfs example (#2871)
* Use sshfs 

Example how to use sshfs instead of using samba.

* Update format
2017-06-23 22:03:01 +02:00

46 lines
1.5 KiB
Markdown

---
layout: page
title: "SSH Server"
description: "Allow logging in remotely to your server using SSH."
date: 2017-04-30 13:28
sidebar: true
comments: false
sharing: true
footer: true
---
Setting up an [SSH](https://openssh.org/) server allows access to your Hass.io folders with any SSH client. 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].
```json
{
"authorized_keys": [
"ssh-rsa AKDJD3839...== my-key"
]
}
```
Configuration variables:
- **authorized_keys** (*Required*): Your public-keys for authorized keyfile. Every element will be a line inside that file.
[win]: https://www.digitalocean.com/community/tutorials/how-to-create-ssh-keys-with-putty-to-connect-to-a-vps
[other]: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/
<p class='note'>
This add-on is not compatible when you installed Hass.io via the generic Linux installer.
If you're coming from Rasbian or similar, use `root` rather than `pi` when connecting via ssh or else you will get this error.
```bash
Permission denied (publickey,keyboard-interactive)
```
</p>
<p class='note'>
If you install this addon you can use `sshfs` as well to access files from a remote system where you have git and your favourite editing tools installed.
```bash
$ mkdir ~/ha_config
$ sshfs -o allow_other,defer_permissions root@h[your_hassio_ip]:/config ~/ha_config
```
</p>