Using SFTP for Remote File Transfer from the Command Line

////Using SFTP for Remote File Transfer from the Command Line
Using SFTP for Remote File Transfer from the Command Line2020-07-28T10:35:52+00:00

Using SFTP for Remote File Transfer from the Command Line

Instantiating an SFTP Connection with a Remote Host


Like SSH, SFTP can be run natively from the shell. This is true of macOS and Linux machines, and is also true of any up-to-date Windows 10 PC (SSH support was added in the Win10 April 2018 update) via PowerShell.  When you are at the command line, the command used to start an SFTP connection with a remote host is:

sftp username@hostname 

For example, a user with the username user connecting to the remote host ada would use the following command: 


SFTP will then ask for the password to the account you’re trying to log into. After inputting it, the SFTP connection will be instantiated. An SFTP prompt will appear, looking like the following:


From here, you can use a few basic linux-like commands to navigate both your directory of your local computer and the remote directory you’re connected to. To end your SFTP session, use the exit command. For a full list of SFTP commands, including those outside the scope of this guide, use the help command. 

Remote/Local Directory Navigation/Interaction

Remote Directory


The pwd command will print your current remote directory path.

The ls command will print the contents of current directory. It can be used with the -l flag to display directory content as a list, or with the -a flag to display hidden files and directories. These flags may be used in conjunction to display all files in a list.

The cd command can be used to change to a different directory. For example, cd Documents would move your working directory to Documents, assuming it existed as a sub-directory within the directory from which you ran the command.

Use cd .. in order to move to the parent directory, e.g. from /home/Documents/ to /home/.

Local Directory


The aforementioned commands are within the context of the remote directory. In order to navigate your local directory, preface any of the above commands (ls, cd, pwd) with the letter l, like so: 

lls, lpwd, lcd 

This indicates the command is to take place in the local directory.

Transferring Files


In order to copy a file from the remote directory to the local directory, use the command get. Get expects at least one argument, which specifies the name of the file. This can either be just the filename if it’s in your current working directory, or an absolute file path. If a destination path isn’t specified as a second argument, the get command will default to your local working directory.

To send files to the remote directory, use the put command. This works basically the same as the get command. You must specify the file to be sent to the remote directory, either by name (only if within the current working directory) or absolute file path. If a destination path isn’t specified as a second argument, the put command will default to the remote working directory. 

Copying a directory via SFTP is slightly more complicated. This is because most command line implementations of SFTP cannot directly copy a directory, instead you can only copy the contents of a directory. In practice, this means the outermost layer of (i.e., the directory itself) will not be copied. You will usually have to make it yourself. Begin by creating a local directory using the command lmkdir directoryname to create a local directory of your choice. Next, use lcd directoryname to navigate your working directory into the empty directory you’ve just created. Move inside the remote directory you want to copy. From within the remote directory, copy all the files using the command get -r *. This will copy all files and subdirectories contained within the directory. This process works same way for transferring a directory to the remote host, but uses the put command.

Another option is to simply compress the directory you’re trying to move, at which point the compressed folder can be transferred like any other file.


MCECS Specific Information

Using SFTP to Transfer Files to/from Stashes


From within your SFTP session, type cd /stash/yourstashname. Please be aware that your stash will not show up in the stash directory if you look for it using ls – it can only be accessed directly.

Connecting to your Windows N: drive


To access your N: drive via STFP, connect to



Note: SFTP uses the SSH protocol, which means that it works natively with any SSH keys you may have configured.