Subversion Repositories

Introduction

Subversion is a centralized version control system that was designed as the successor to CVS. It has been the de facto standard for open source projects and small development teams alike for many years.

This guide assumes that you have already installed the latest Subversion client onto your development machine.

Authentication

Repository Hosting offers both public and private access to Subversion repositories over both HTTP(S) and SSH. SSH is generally faster, but you can use HTTP if you need to connect to your repository through a corporate firewall. When accessing private repositories, or public repositories to which you are committing, you must use the private URL (beginning with "/svn/" and not "/svn_public/") and you must provide the same account credentials you use to access the Repository Hosting web interface.

Repositories accessed over SSH require the use of a public keypair. For more information on how to create a keypair and use it with Repository Hosting, please reference Generating an SSH Keypair.

There are also two ways you may view your repository directly from your browser. You may view it in Trac using the "Browse Source" tab, or you can access a simple file view by going to the HTTP repository URL in your browser.

Checkout

To checkout a private Subversion repository, you may do the following:

$
svn checkout https://prd.repositoryhosting.com/svn/prd_dock dock

or for SSH:

$
svn checkout svn+ssh://svn@prd.repositoryhosting.com/prd/dock dock

or for public repositories:

$
svn checkout https://prd.repositoryhosting.com/svn_public/prd_dock dock

Importing Dump Files

You may have an existing project in Subversion which you would like to have hosted with Repository Hosting. We would be glad to import a repository dump file for you. We will require the dump file for your repository (as created with 'svnadmin dump'). This dump file can be uploaded from the Repository tab of the Project Settings page, or if it is very large, you can make it available somewhere online (S3, FTP, etc.) and we will download and import it for you.

Further Reading

There is now a vast amount of information available on how best to use Subversion. For starters, we suggest the following: