User Tools

Site Tools

tools:sftp

This is an old revision of the document!


Secure File Transfer Protocol (SFTP)

Secure File Transfer Protocol (or SFTP, and also known as SSH File Transfer Protocol), is an extension of SSH that provides encrypted file transfer capabilities. Since it is built into SSH, it is one of the easiest ways to transfer files between system, as in many cases you won't have to configure additional software to use it.

Using SFTP

SFTP is a widely-supported protocol, so you can use it in a variety of applications. Here are the most important ones:

Command Line

For Linux, BSD & MacOS users, your local shell is by far the quickest way to transfer files using SFTP:

Connecting

Connecting to an SFTP server works exactly the same as connecting to an SSH server - you just use the sftp instead of the ssh command, and when prompted give your password:

$ sftp username@domain.com

or

$ sftp username@123.123.123.123

Since SFTP is part of SSH, that means the preset aliases in your .ssh/config file will all work with the sftp command. If you have not created one of these files, you will want to, as it enables automatically passing public/private key pairs for convenient password-less authentication. Read SSH Configuration for more information on how to do this.

Traversing an SFTP system works much the same way as it does in bash - in fact it uses simplified versions of many of the same commands, albeit in a reduced form.

Finding Your Location

Use pwd to show your current location (the 'present working directory') on the remote server:

sftp> pwd
Showing Directory Contents

Use the ls command to show the contents of the pwd. Use ls -la to show a more detailed listing with metadata:

sftp> ls
sftp> ls -la
Moving Around

Use the cd command to change the pwd:

sftp> cd path/to/directory/

Downloading Files

Uploading Files

Advanced Wizardry

SFTP in PowerShell

For unfortunate Windows users with PowerShell, you do not have SFTP support built-in. You will have to set up Posh-SSH to use SFTP from your shell with your local filesystem.

Graphical Applications

If command line is too daunting for you, you can always install programs like Filezilla or WinSCP to visually browse the SFTP server. Many other programs support SFTP connections as well.

See what works for you, but we recommend getting familiar with the CLI sftp command instead.

tools/sftp.1758671020.txt.gz ยท Last modified: (external edit)

Find this page online at: https://bestpoint.institute/tools/sftp