File Management

In addition to using the web based File manager, SourceForge also provides access to various filesystems using the ssh protocol suite for securely managing content for your project using SCP, SFTP, and rsync.

• Authentication and Server Hostnames
• Access paths
• Common SFTP Clients
• Common SCP Clients
• rsync over SSH
• Example sessions
  • Uploading a file release using the command line scp client
  • Uploading Project web content using rsync
  • Uploading Developer web content using the command-line SFTP client
  • Backing up File Release System content via rsync

Authentication and Server Hostnames

• Username: your login username
• Password: your SourceForge password. Alternatively, you may also use [SSH Keys].
• Hostname: web.sourceforge.net or frs.sourceforge.net (these are alias to the same server)
• Port: 22

The first time you connect to web.sourceforge.net or frs.sourceforge.net you will be prompted to check the SSH Key Fingerprints, to check these, please see the following SSH Host Key Fingerprints list.

Access paths

For the following paths, replace PROJECTNAME with your project's URL name, and replace USERNAME with your login username.

• File Release System: /home/frs/project/PROJECTNAME/
• Project Home Directory: /home/project-web/PROJECTNAME/
• Project web: /home/project-web/PROJECTNAME/htdocs/ and /home/project-web/PROJECTNAME/cgi-bin/
• Developer web: /home/user-web/USERNAME/htdocs/ and /home/user-web/USERNAME/cgi-bin/

Note: In many cases, intermediate directories will appear empty (eg., /home/project-web/ ), but their contents are simply hidden. You want to use the full path as indicated above.

Common SFTP Clients

• sftp, a command-line client included in OpenSSH, available on Mac OS X, Linux, and BSD natively; and on MS Windows through Cygwin.
• psftp, a command-line client included in PuTTY, available for MS Windows.
• WinSCP, a graphical client available for MS Windows.
• Filezilla, a graphical client available for MS Windows, Mac OS X, and Linux.

Common SCP Clients

• scp: a command-line client included in OpenSSH, available on Mac OS X, Linux, and BSD natively; and on MS Windows through Cygwin.
• pscp: a command-line client included in PuTTY, available for MS Windows.
• WinSCP: a graphical client available for MS Windows.

rsync over SSH

rsync is a tool that provides fast, efficient file transfers. rsync is available for all major OS platforms; it is natively included on Linux, Mac OS X and BSD, and is available for MS Windows users through Cygwin. rsync can be run in conjunction with SSH for secure, encrypted file transfers. rsync supports resume of failed transfers, a life-saver on large file transfers. The versatility of rsync is unequaled -- it provides a vast array of options to help you customize your file transfer operation to meet your exact needs.

rsync is also very useful for only uploading content which is new or has changed. As such, it is a very good choice for syncing locally stored directories, or backing up content without needing to download the whole tree each time.

Example sessions

Uploading a file release using the command line scp client

An example session might look like (where Username="jsmith", Project URL name="fooproject", Release dir is "Rel_1"):

$ scp new_release_0.5.zip jsmith@frs.sourceforge.net:/home/frs/project/fooproject/Rel_1
Connecting to frs.sourceforge.net...
The authenticity of host 'frs.sourceforge.net (216.34.181.57)' can't be established.
RSA key fingerprint is 68:b3:26:02:a0:07:e4:78:d4:ec:7f:2f:6a:4d:32:c5.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'frs.sourceforge.net,216.34.181.57' (RSA) to the list of known hosts.
jsmith@frs.sourceforge.net's password:
new_release_0.5.zip                                               100%  241     0.2KB/s   00:01

Uploading Project web content using rsync

An example session might look like (where Username="jsmith", Project URL name="fooproject"):

$ rsync -avP -e ssh site/ jsmith@web.sourceforge.net:/home/project-web/fooproject/htdocs/
building file list ... 
4 files to consider
./
image1.png
       73342 100%   38.69MB/s    0:00:00 (xfer#1, to-check=2/4)
image2.png
       34694 100%   33.09MB/s    0:00:00 (xfer#2, to-check=1/4)
index.php
          50 100%    4.07kB/s    0:00:00 (xfer#3, to-check=0/4)

sent 108369 bytes  received 92 bytes  5862.76 bytes/sec
total size is 108086  speedup is 1.00
$ 

Uploading Developer web content using the command-line SFTP client

$ sftp jsmith@web.sourceforge.net
Connecting to web.sourceforge.net...
The authenticity of host 'web.sourceforge.net (216.34.181.57)' can't be established.
RSA key fingerprint is 68:b3:26:02:a0:07:e4:78:d4:ec:7f:2f:6a:4d:32:c5.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'web.sourceforge.net,216.34.181.57' (RSA) to the list of known hosts.
jsmith@web.sourceforge.net's password:
sftp> cd /home/user-web/jsmith/htdocs/
sftp> put *
Uploading image1.png to /home/user-web/ctsai/htdocs/image1.png
image1.png                                                         100%   72KB  71.6KB/s   00:00    
Uploading image2.png to /home/user-web/ctsai/htdocs/image2.png
image2.png                                                         100%   34KB  33.9KB/s   00:00    
Uploading index.php to /home/user-web/ctsai/htdocs/index.php
index.php                                                          100%   50     0.1KB/s   00:00    
sftp> exit

Backing up File Release System content via rsync

An example session might look like (where Username="jsmith", Project URL name="fooproject"):

$ rsync -avP -e ssh jsmith@frs.sourceforge.net:/home/frs/project/fooproject/ file-backup/
receiving file list ... 
4 files to consider
./
dummy_file_10mb
    10000000 100%    2.03MB/s    0:00:04 (xfer#1, to-check=2/4)
new_10mb_file_different_filename
    10000000 100%    1.85MB/s    0:00:05 (xfer#2, to-check=1/4)
readme
         127 100%    0.13kB/s    0:00:00 (xfer#3, to-check=0/4)

sent 88 bytes  received 20005318 bytes  1212448.85 bytes/sec
total size is 20000127  speedup is 1.00
$