Toolserver:Transferring files


This page was moved from the Toolserver wiki.
Toolserver has been replaced by Toolforge. As such, the instructions here may no longer work, but may still be of historical interest.
Please help by updating examples, links, template links, etc. If a page is still relevant, move it to a normal title and leave a redirect.

Getting started

Default files and directories[edit]

There are a number of files that are created automatically along with your Toolserver account.

File / directory Description This file (see contains information about you (name, e-mail address, etc.). It is used to generate a listing here.
.forward This file contains the e-mail address to which system e-mail (e.g. cron) will forward.
.my.cnf This file contains your username and password to access the SQL databases.
public_html/ This directory is the web-accessible directory that loads when you visit
Note: Because this directory is directly accessible from the Internet, it should not contain any non-public information such as passwords.

Transferring files[edit]

To transfer files to the Toolserver, you can either connect through the command-line interface or via a GUI. The Toolserver uses SSH, which supports two file transfer protocols: SCP and SFTP. SCP is useful for transferring a single file or directory, while SFTP provides a more FTP-like interface (although the implementation is completely different from FTP). A list of SFTP clients for various operating systems is available here.


Most Unix-like operating systems include the OpenSSH SSH client, which provides the sftp program, a simple command-line interface to SFTP.

To use it, run:

sftp <user>@<server>

Then enter the passphrase for your private SSH key. You will be presented with an SFTP command prompt; type help to list the available commands.

To connect using SFTP and a GUI program, you will need to use the following information:

  • Protocol: SFTP
  • Port: 22
  • Server: <server> (see login servers)
  • Username: your username
  • Password: You will need to configure your client to use your SSH key.


For SCP, OpenSSH includes the scp program. This is an SSH version of the rcp command; it copies a single file or directory to or from a remote system (or between two remote systems).

To copy filename from your local computer to Toolserver, run

scp filename <server>

You can also specify the directory or filename for the destination file:

scp filename <server> (specify the directory)
scp filename <server> (specify the filename)

To copy from toolserver to your local computer, run

scp <server> . ("." means the current directory)

Suggested clients[edit]

  • WinSCP (Windows)
  • FileZilla
  • OpenSSH provides 'scp' and 'sftp' commands, described above
  • SecureCRT built-in SFTP client (Windows)
  • lftp (Unix, command-line)
  • Transmit (Mac)
  • Cyberduck (Mac)
  • Coda (Mac)

See also[edit]