[[PageOutline]]

= Using rsync for backups =

[wiki:"What is SourceForge.net?" SourceForge.net] provides read-only rsync access to a number of service offerings to enable self-service [wiki:"Backup your data" backups of project data].  `rsync` is the preferred tool for making backups, since it provides great flexibility, supports resume of failed transfers, and is optimized for efficient data transfer.

rsync clients are available for all modern Operating System platforms.  Linux, BSD and Mac OS X users typically already have [http://samba.org/rsync/ rsync] installed, since it is typically included with the Operating System.  MS Windows users can obtain rsync from the [http://www.cygwin.com/ Cygwin] project.

= CVS =

[wiki:"CVS"] repository contents may be accessed (read-only) by the project team and end-users using rsync.  

rsync may be used to copy an entire project repository (replace `PROJECTNAME` with the UNIX group name of the project) as follows:

{{{
$ rsync -av PROJECTNAME.cvs.sourceforge.net::cvsroot/PROJECTNAME/* .
}}}

We do not permit access to the whole `cvsroot` module (i.e. to copy every project repository we host all at once) for sake of performance.  Access is provided on a per-project basis instead.

To restore [wiki:"CVS"] data, make use of the `adminrepo` command with our [wiki:"Shell service#shellcommands" interactive shell service].

= Subversion = 

'''''Note''''': if you are on the New SourceForge platform, see [http://sourceforge.net/p/forge/documentation/rsync%20Backups/#new-sourceforge-project-scms these instructions instead].

[wiki:"Subversion"] repository contents may be accessed (read-only) by the project team and end-users using rsync.  

rsync may be used to copy an entire project repository (replace `PROJECTNAME` with the UNIX group name of the project) as follows:

{{{
rsync -av PROJECTNAME.svn.sourceforge.net::svn/PROJECTNAME/* .
}}}

We do not permit access to the whole `svn` module (i.e. to copy every project repository we host all at once) for sake of performance.  Access is provided on a per-project basis instead.

To restore [wiki:"Subversion"] data, make use of our [wiki:"SVN adminrepo#ImportingfromotherreposincludingotherSCMs" Subversion import facility].

= Git, Bazaar, Mercurial =

'''''Note''''': if you are on the New SourceForge platform, see [http://sourceforge.net/p/forge/documentation/rsync%20Backups/#new-sourceforge-project-scms these instructions instead].

rsync can also be used to backup [wiki:"Git#Backups" Git], [wiki:"Bazaar#Backups" Bazaar], and [wiki:"Mercurial#Backups" Mercurial] repositories.

= Project web and developer web =

[wiki:"Rsync over SSH" Read-write rsync access] to [wiki:"Project web" project web] and [wiki:"Developer web" developer web] content is available to project developers using our [wiki:"File management service" file management service].

= Getting Help =

 * The [http://samba.org/ftp/rsync/rsync.html manpage] for rsync
 * [wiki:"Support"]
 * [wiki:"Request an enhancement"]

[[Include(__footer)]]