Creating a Subversion Repository

From OCS Support Wiki

Jump to: navigation, search

Contents

[edit] Introduction

This guide will show you how to create a Subversion repository on your new Subversion and Trac account. If you have not requested a Subversion and Trac account, please see Request a Subversion and Trac Account before beginning this guide.

[edit] Creating a Subversion Repository

Login to the URL you were given in your Subversion and Trac account welcome e-mail.

Once logged in, you'll see a menu similar to this one:

image:svn1.gif

Expand the Services tab and select "SVN Repositories" as shown in the graphic above. You will see a dialog asking for the information to create a new repository, like this:

image:svn2.gif

Enter the name you want to give to your new Subversion repository in the "Repository name" field. It must be one word without spaces or special characters. No other changes are required to this form, but make sure "Repository type" is set to "Versioned Filesystem (FSFS)". If you want to allow anonymous read-only access to your repository, you can set that as well. When finished, click "Create".

Once the repository is created, you'll see it in your list. You can at that point restore a backup of a previous repository if you choose to do so.

[edit] Assigning SVN Permissions

To begin with setting permissions, you will need to give yourself access to the repository. To do this, click on the "Edit Mail and FTP Users" link on the left-hand side menu and click on your username. You can edit various items about your username here, but you will want to expand the section titled "Other User Permissions". You'll see a dialog similar to this:

image:svn3.gif

As highlighted in the above graphic, enable access to the repository and select it and any other repositories that you have created to give yourself permission to access and write to them. Click Save to save your changes.

[edit] Creating Additional Subversion Users

You can create additional users to access the Subversion repository by click on "Edit Mail and FTP Users" and clicking "Add a user to this server". Enter the username in the e-mail address field, their password, and expand the "Other user permissions" tab like you did before when giving yourself rights to the repository to assign that user to have read/write access to the repositories you want.

Please note that the username that you create is not the same username that you'll use in Subversion. After saving the user, refer to the "POP3/FTP login" column in the table that lists your users for the Subversion username.

[edit] Accessing your Subversion Repository

To access your Subversion repository, please see Accessing Your Subversion Repository.

[edit] Trac

If you would like to install Trac, please see Installing_Trac.