From b3c6f5f4b85de40e19057fc356150d73fcee5cc5 Mon Sep 17 00:00:00 2001 From: Nick Craig-Wood Date: Thu, 19 Apr 2018 10:15:54 +0100 Subject: [PATCH] sftp: Update docs with Synology quirks --- docs/content/sftp.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/content/sftp.md b/docs/content/sftp.md index 270e9ef94..bcd766020 100644 --- a/docs/content/sftp.md +++ b/docs/content/sftp.md @@ -10,13 +10,16 @@ date: "2017-02-01" SFTP is the [Secure (or SSH) File Transfer Protocol](https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol). -It runs over SSH v2 and is standard with most modern SSH -installations. +SFTP runs over SSH v2 and is installed as standard with most modern +SSH installations. Paths are specified as `remote:path`. If the path does not begin with a `/` it is relative to the home directory of the user. An empty path `remote:` refers to the user's home directory. +Note that some SFTP servers will need the leading `/` - Synology is a +good example of this. + Here is an example of making an SFTP configuration. First run rclone config @@ -173,6 +176,10 @@ which are not under your control, and to which the execution of remote commands is prohibited. Set the configuration option `disable_hashcheck` to `true` to disable checksumming. +Note that some SFTP servers (eg Synology) the paths are different for +SSH and SFTP so the hashes can't be calculated properly. For them +using `disable_hashcheck` is a good idea. + The only ssh agent supported under Windows is Putty's pageant. The Go SSH library disables the use of the aes128-cbc cipher by