docs: clarify and add examples for sftp docs

- added clarification to default remote path if no path is specified 
- added examples for mounting a remote path (other than the default home directory) to a local folder.
This commit is contained in:
Kenny Parsons 2021-04-26 10:13:42 -05:00 committed by GitHub
parent 0537791d14
commit 4cacf5d30c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -21,7 +21,10 @@ SSH installations.
Paths are specified as `remote:path`. If the path does not begin with 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 a `/` it is relative to the home directory of the user. An empty path
`remote:` refers to the user's home directory. `remote:` refers to the user's home directory. For example, `rclone lsd remote:`
would list the home directory of the user cofigured in the rclone remote config
(`i.e /home/sftpuser`). However, `rclone lsd remote:/` would list the root
directory for remote machine (i.e. `/`)
"Note that some SFTP servers will need the leading / - Synology is a "Note that some SFTP servers will need the leading / - Synology is a
good example of this. rsync.net, on the other hand, requires users to good example of this. rsync.net, on the other hand, requires users to
@ -84,6 +87,10 @@ See all directories in the home directory
rclone lsd remote: rclone lsd remote:
See all directories in the root directory
rclone lsd remote:/
Make a new directory Make a new directory
rclone mkdir remote:path/to/directory rclone mkdir remote:path/to/directory
@ -97,6 +104,11 @@ excess files in the directory.
rclone sync -i /home/local/directory remote:directory rclone sync -i /home/local/directory remote:directory
Mount the remote path `/srv/www-data/` to the local path
`/mnt/www-data`
rclone mount remote:/srv/www-data/ /mnt/www-data
### SSH Authentication ### ### SSH Authentication ###
The SFTP remote supports three authentication methods: The SFTP remote supports three authentication methods: