Assembla Subversion (SVN) integration makes it easy for your entire software team to collaborate on code development and changes with built-in features like auditing, permission management, and code reviews.

This article helps you get started so you can start pushing changes to your repository.

Adding a repository to your space

If SVN is not listed as an installed tool in your space, you must add an SVN repository. If you already have an SVN tool installed in your space, skip to the next topic regarding importing existing data.

To complete these steps, you must have owner permission to the spaces.

To add a SVN repository to your space

In Assembla, select Admin > Tools.
Next to SVN, click Add (or Add another).
The newly-added SVN repository appears in your navigation bar named, SVN (number - if any).

Importing existing data

You can add data from multiple sources to your SVN repository. This includes importing data from either SVN dump files of previous repositories or uploading unversioned files.

Importing an SVN dump file

If you already have an SVN repository, you can import it directly to Assembla.

To import an SVN repository from another server

Obtain an SVN dump file for the source repository. The steps for obtaining an SVN dump file varies depending on the SVN service provider hosting the repository, but in most cases you can create it by using the following command:
```
svnadmin dump /path/to/repository | gzip -9 > svnexport.dump
```
Add an empty SVN repository to your Assembla space as shown in the previous section.
Go to the Import/Export sub-tab in the SVN tab for your newly-created repository.
Browse for and select the SVN dump file from your computer, and then click Import. If your file is larger than 2000 MB, you will need to use a URL to import it instead. An import job is scheduled and runs in the background.

For more detailed instructions, see Migrating SVN Repositories to Assembla.

Uploading unversioned files to your repo

If you currently organize your project files in an unversioned directory structure, then they must be added to your Assembla SVN repo before you can start committing your changes to those files. To learn more, check out Adding Unversioned Files to Your SVN Repository.

For users with the new UI

Creating a space

After logging in, you can either click the green (+) button, and then Create New Space or you can select Create New Space from your Portfolio home page.

Provide a unique name for your space. If the space name is already taken, please use a different name.

Once you name your space, choose your set of tools. If you would like to remove repositories, or add or remove other tools to your space at any point, go to Admin > Tools. Click Add next to the tool you want to add.

Note: If you are not the owner or payer of the space, you do not have access to that space's Admin tab.

Adding a repository to your space

When creating a new space, you can create the space with a repository by checking Create with repository on the first step.

Alternatively, if you would like to create a repository in an existing space, click the green (+) button, and then select New Repository. The wizard asks you to select the space in which you want to create your repository, as well as what you would like to name your repository and what type of repository it is.

If you want to import an existing repository from an external location, click Import repository, and then type your repository's URL and, if necessary, access credentials.

Checking out your SVN repository

To check out your SVN repo, go to the Source sub-tab of the SVN tab and find the URL for the appropriate SVN repository.

Note: If you are having issues with a caret (^) in your URL, replace each caret with "%5E"

Next, get an SVN client. Here are our suggestions for common operating systems:

Windows: TortoiseSVN
Mac: Cornerstone, or command line
Linux: SmartSVN

Finally, check out your repository using the correct guide below.

Checking out your SVN repo using Windows

We recommend using TortoiseSVN as a Subversion client for Windows.

Precondition: Make sure you have an Assembla password. If you signed up with your Google or Yahoo account, you might need to create an Assembla password. To set one, simply go to your profile page and create a password.

To check out for Windows-based repos

Create a folder in your local file system. Right-click inside of the folder where you want to checkout the repository, and then select SVN Checkout from the pop-up menu.
In the new pop-up window, enter the URL for your Assembla-hosted SVN repository, and then click OK. You can copy the URL from the SVN repository Source tab on Assembla.
When prompted, enter your Assembla username and password, and then press Enter to check out the repository.

Checking out your SVN repo using Mac and Linux

To check out for Mac & Linux-based repos

Create a local folder.
```
$ mkdir My_SVN
```
Go to that folder.
```
$ cd My_SVN
```

Check out the repository. This step creates a new folder inside of your SVN folder, which is your repository.

$ svn co --username assembla_username --password assembla_password https://subversion.assembla.com/svn/your_space/

Go to trunk.
```
$ cd your_space/trunk
```
Add or make changes to the repository.
```
$ nano xyz.txt
```
Add the local file to your changes.
```
$ svn add xyz.txt
```
If you see the error "W150002", run --force at the end.
```
$ svn add xyz.txt --force
```
Go back to root.
```
$ cd ..
```
Commit the changes to your repository.
```
$ svn commit -m "Commit Message"
```
Update your repository.
```
$ svn update
```

If you have any questions or need assistance, please email us at support@assembla.com.