Last year I took a look at a number of Subversion clients for OS X, finally settling on Versions as my client of choice for my personal coding needs. At the time, I was running a Linux server on some old generic hardware from the days before I drank the Apple Koolaid. After deciding to upgrade my wife’s 17″ iMac with the new i5 27″ model, I realized I could ditch the old Linux hardware and get some great power savings (and hence reduced electricity bill) in the process. The first task I had was moving my SVN repository over from the Linux machine (Ubuntu 9.10) to the iMac running OS X 10.6…and this is how I did it.

All of the SVN application binaries, including the server, already come pre-installed with OS X 10.6, located in the /usr/bin/ directory, so we just have a few steps to get that running.

1. Create a system user for SVN.
2. Create a new repository to store your code in.
3. Optionally create specific SVN users for submission tracking.
4. Configure the server to run automatically at system startup.

Creating an SVN user

While you could easily run the SVN sever with the root user account, for better system security it’s always best to have a dedicated user to run a specific service such as SVN. This limits any possible vulnerabilities in the SVN software from harming the rest of your system; if an exploit is used to end up with a command line ability, the attacker can only damage files belonging to the SVN user.

1. Open System Preferences and go the Accounts page.
   
2. Add a new standard user named svn with a suitable password.
   

This user will be included in the OS X login screen when you start your computer. Since there is usually no reason for somebody to log onto the desktop with this user, it can be hidden from the login screen. You can do so by opening the Terminal application and running the following command:

sudo defaults write /Library/Preferences/com.apple.loginwindow HiddenUsersList -array-add svn

If you ever do want to login as the svn user to the desktop, you can click the new ‘Other’ option that appears in the login screen and manually enter the username. On the other hand, if you don’t want the ‘Other’ option at all you can also disable this by entering the following in a terminal window:

sudo defaults write /Library/Preferences/com.apple.loginwindow SHOWOTHERUSERS_MANAGED -bool FALSE

You can also delete all the default directories created under the /Users/svn/ directory if you prefer a neat and tidy file system.

Creating your SVN repository

We now need to create the specific root directory for our repository and create it using the svnadmin command by launching the OS X Terminal application and entering the following commands.

sudo -u svn mkdir /Users/svn/svnroot
sudo -u svn svnadmin create /Users/svn/svnroot

You can now view the /Users/svn/svnroot directory and see that new files have been created to form the base of your new repository.

Creating SVN users (optional)

If you are working on your own code and you know without a doubt that nobody else will be accessing your repository, you can skip this step. However it doesn’t hurt to configure a dedicated user now even if it’s just for your sole use, so that code check-ins are properly attributed. To do this we first need to edit the svnserve.conf file and enable the passwd file for user authentication. An easy way from the terminal to edit a file is by using the nano text editor:

sudo -u svn nano /Users/svn/svnroot/conf/svnserve.conf

Remove the # from line 20 so it looks like this:

  ### Uncomment the line below to use the default password file.
  password-db = passwd

If using nano, press Control+X and save your changes. Next edit the passwd file:

sudo -u svn nano /Users/svn/svnroot/conf/passwd

Then add the desired usernames and passwords, in my case I’m adding the user ‘bed’ for myself:

### This file is an example password file for svnserve.
### Its format is similar to that of svnserve.conf. As shown in the
### example below it contains one section labelled [users].
### The name and password for each user follow, one account per line.
[users]
bed = beds_secret_svn_password

Scheduling the server to start automatically

OS X uses the launchd subsystem for automatically starting background services. The easiest way to configure svnserve to run automatically via launchd is by using Lingon. You can grab the latest version from Sourceforge. For more details on using Lingon see this previous article I put together, but for this task we just need to add a new User Daemon:

1. Run Lingon, click the New button and select User Daemons.
   
2. Fill out the dialog as follows:
   Name: org.subversion.svnserve
   What: /usr/bin/svnserve --inetd --root=/Users/svn/svnroot/

   

We now need to click the “Expert” button at the bottom and add the following text under the <dict> section:

<key>Sockets</key>
<dict>
  <key>Listeners</key>
  <dict>
    <key>SockFamily</key>
    <string>IPv4</string>
    <key>SockServiceName</key>
    <string>svn</string>
    <key>SockType</key>
    <string>stream</string>
  </dict>
</dict>
<key>inetdCompatibility</key>
<dict>
  <key>Wait</key>
  <false/>
</dict>
<key>Umask</key>
<integer>2</integer>
<key>UserName</key>
<string>svn</string>
<key>GroupName</key>
<string>staff</string>

So that it looks like this:

Click the save button again and then reboot your computer to give it a test by connecting to localhost or your IP address with your favorite SVN client, ie: svn://bed@localhost. Your SVN server is now ready to be used! The SVN server will only be launched when you first try and use it, so it won’t be taking up any unnecessary resources.

Migrating an existing repository

If you’re like me, and want to migrate an existing repository from another system you can do so easily by skipping the svnadmin command in step two, and just copy the repository directory from the old system to the new system. I would advise to upgrade your existing repository first to ensure that it is compatible with the version of SVN that comes with OS X (SVN version 1.6.x). Also you’ll want to ensure that the copied file’s owner becomes the new SVN user created in step one.

Subversion (also known as SVN) is a popular version control system. Accessing SVN repositories with OS X is easy – and there are numerous options to do so. In this article we’ll cover 12 different applications that let you access and use Subversion in OS X.

Version 1.4 of the command-line SVN client ships with OS X Leopard and is the quickest way to get started (for OS X Tiger, or if you need SVN 1.5 an easy installer can be found here). All you need to do is fire up the Terminal application and type svn with the required parameters. A great resource to learning how to use the command-line client (and all the functionality of Subversion) can be found at Version Control with Subversion – a free online book. From the command line you can do everything required. In fact, some people will swear against doing anything SVN-related without dealing directly with the command line.

However there are reasons most of us love OS X, and a large number of those reasons relate to the great user interface experience. So what tools are there that can expose SVN functionality via a user interface?

Mac-Only SVN Clients

XCode

If you have a need to access a subversion repository with OS X, you are likely to already be familiar with XCode, Apple’s development IDE. Like most good IDEs, XCode has built-in support for version control, including SVN (as well as CVS and Perforce). This works well for basic functionality and if the scope of your needs falls within OS X and/or iPhone development, this will do the job.

svnX

svnX is an open source SVN client that uses the SVN command-line client to do the actual work and for a long time it was the best fully-featured native OS X client. The UI, however, is not what we have all come to expect from a great OS X application and it hurts the user experience. Nonetheless, for a free UI solution, one can’t complain.

Versions

Versions is a relatively recent commercial subversion client, made specifically for OS X, and looks like it belongs. It costs €39 ($50), but that’s a reasonable price to pay for such functionality with polish. A 21-day trial can be downloaded for free. Along with Cornerstone described below, it is the cream of the OS X Subversion clients.

Cornerstone

Like Versions, Cornerstone is a commercial subversion client made specially for OS X that leverages its UI. At $69 (a free 14-day trial can be downloaded) it has feature parity with Versions and can also be considered a premium solution for accessing Subversion on OS X.

SCPlugin

SCPlugin is an open-source client that integrates with Finder and enables you to work with your source without loading a separate application. Using icon overlays, it enables you to see at a glance the state of your files, letting you perform SVN actions via the standard Finder popup menu. This was inspired by TortoiseSVN, a popular Windows SVN tool that integrates with Explorer.

SCPlugin is still in development and while it’s mostly functional, there are still issues with reliably badging the icons (you also need to turn off Finder’s Icon Preview feature). Nonetheless, the crucial SVN functionality (checkout, update, commit) work well. When its issues get ironed out this will be a killer solution.

Of note, this can be installed and used along with another option (ie. Versions or Cornerstone) and will simply reflect the SVN status of a local working directory by reading SVN’s hidden control files.

iSVN

iSVN is currently still in development and available for free (license for the final release is still to be determined by the author), however it is quite functional in its pre-release form and requires the command-line SVN client.

Subversion Scripts for Finder

These are a collection of Apple Scripts that enable you to work with SVN directly from within Finder via Finder Scripts. Unlike SCPlugin, these are less intrusive and do not modify the look of Finder in any way. They offer a good middle ground for power users who are used to using SVN on the command line and want a quicker way to perform actions. They also allow for productive use with QuickSilver. It requires the standard SVN command-line client.

Cross Platform SVN Clients

In addition to the above native OS X applications, there are numerous cross-platform clients that will run on OS X. While the big disadvantage to these is the lack of an OS X-friendly user interface, if you need to access Subversion across different platforms, and would like to use the same client everywhere, these will give you a standard and consistence interface. The following clients ran without issue on my OS X 10.5.6 system.

RapidSVN

RapidSVN is an open-source client for Windows, Linux, OS X and other *nixes. It’s simple and functional but requires third-party tools for functionality such as visual Diffs. Its written in C++ and executes native code, so it’s the fastest cross-platform client.

SmartSVN

SmartSVN is a powerful Java-based client that is offered in a basic open-source variety and an advanced commercial variety ($79). While it is Java-based, there are specific versions for Windows, OS X and Linux, each supporting their native environments (the OS X version will add custom popup menus into Finder as an example).

Syncro SVN Client

SyncroSVN is another fully featured, commercial Java-based client available for windows, OS X and Linux, tailored to each platform. It retails for $99 and a free 30-day trial is available. This suffers more than the other cross-platform clients with regards to the user interface (I have never seen MDI child windows with OS X style window management buttons in any other application before).

JSVN

JSVN is a very no-frills, open-source option and is quite functional. It is by far the fastest Java-based client.

Subclipse

Subclipse is an add-on to the cross-platform Eclipse IDE (which is Java-based, but language independent) . This requires you to upgrade the command-line SVN client that comes with Leopard from 1.4 to 1.5, however, and is best suited to those who already use Eclipse regularly.

What do you think?

What’s your favorite Subversion client for OS X? Are there any other clients I don’t know about? Let us know with a comment.

Related research and analysis from GigaOM Pro:
Subscriber content. Sign up for a free trial.

• Why iPad 2 Will Lead Consumers Into the Post-PC Era
• The Near-Term Evolution of Social Commerce
• Content Farms: The Players, The Benefits, The Risks

For one, you can host a Subversion repository anywhere, either locally on your own Mac, or on the Internet, or on your local private network. Second, Subversion is built to work with multiple users, and can handle conflicting commits to the repository. Finally, Subversion can integrated directly into Xcode, which is what we are going to look at here.

Setup Beanstalk

To start, first head over to Beanstalk and create an account. Since I’m only ever working on one project at a time, the free hosting works fine for me, but there are also for-pay plans depending on your needs. Once you have the URL for your repository, it’s time to make some changes in Xcode. I’ll assume that you already have a project that you want to work with, and some code that you are ready to back up.

Setup Xcode

In Xcode, select “SCM”, and “Configure SCM Repositories.” Click on the + button towards the bottom left and add a name for the repository, and select “Subversion” as the SCM System. Add your custom URL. It will look something like this:

http://username@username.svn.beanstalkapp.com/projectname

Where username is your Beanstalk user id, and projectname is the name of your first project. Enter in your password at the bottom, and the red error jewel at the bottom should go green and say “Authenticated.” Now that you have your repository set up, it’s time to add your project to it.

Adding Your Project

Open your project, and again go to the SCM menu. This time there should be a new menu option: “Configure SCM for this project,” select that. This will bring up the info window for your project. At the bottom of the “General” tab, change the SCM Repository selection from “None” to your newly created Beanstalk repository. Close the info window, and go to the SCM menu item again, you should see several more options there. Go down to the bottom and select “Commit Entire Project.” This will upload the project into Beanstalk and set up your project for source control. Once that is finished, it’s time to test it out.

Testing Things Out

Change one of the source code files in your project and save it. You should see a capital “M” (for Modified) in the far left column next to the “Groups and Files” area of Xcode. Right click on the file that you changed and select “Compare.” This will compare the change you just made with the most recently committed change in Beanstalk. If you are happy with the change, you can select “Commit Changes” from the SCM menu item. You should see the “M” disappear.

If you’ve made some changes that didn’t quite turn out the way you expected, it’s easy to roll back to a previous commit. Just select the file that you need to roll back, go to the SCM menu and select “Update to” and “Revision…”. This will let you select which version of the file you’d like to roll back to.

Using Subversion you can keep a detailed record of all the changes you make to a project as it progresses. Using a hosted service like Beanstalk ensures that you can recover from a hard drive failure or other catastrophe with very little effort. We have only just scratched the surface of Subversion, but by now you should be able to set up a repository, add your project to it, and commit and compare changes.

Related research and analysis from GigaOM Pro:
Subscriber content. Sign up for a free trial.

• Why iPad 2 Will Lead Consumers Into the Post-PC Era
• The Near-Term Evolution of Social Commerce
• Content Farms: The Players, The Benefits, The Risks

Fast-forward to this summer when the first public-beta of Versions became available for download. You should have seen Twitter. Web and softare developers were giddy. Since then we’ve seen several updates to an already very nice beta, culminating with the 1.0 version, available today.

Versions offers the ability to visually browse repositories, see changes in your working copies, and easily set up new projects. There’s also a nice timeline view, letting you go back and see all the old edits on files and folers. Versions even gives you an easy way to set up a free remote repository using Beanstalk.

The GUI-based Subversion client idea isn’t new. There are a few applications, like svnX, that have been around for quite awhile. However, if you compare the screenshots and features between Versions and svnX, you can see why Versions is getting the buzz that it is.

Another application to keep an eye on is Cornerstone, which is looking very good. Cornerstone just debuted this summer and seems to be giving Versions a run for its money. This is a fantastic situation, much like VMWare Fusion and Parallels, where we get to see two excellent applications in competition against each other to make the best program.

Versions is a joint venture by Pico and Sofa. It requires Mac OS X 10.4.9 or higher (10.5.2 is recommended). You can download and try Versions for free for 21 days. After that it will set you back around $50.

Related research and analysis from GigaOM Pro:
Subscriber content. Sign up for a free trial.

• Why iPad 2 Will Lead Consumers Into the Post-PC Era
• The Near-Term Evolution of Social Commerce
• Content Farms: The Players, The Benefits, The Risks

Versions is an app that provides a strong GUI front-end for the “svn” (Subversion) command-line application. I, personally, prefer a GUI over command-line, but the benefits of Subversion were worth the hassle to me in my Cocoa development. We’ve discussed Subversion and its uses and benefits in quite a few places here on TAB before, so it’s nice to finally see an app like this come along.

Scott Stevenson had posted an earlier sneak peek of the app last week, and his comments area sparked a “war” of sorts amongst users of other version-control systems, saying that SVN is no longer “cool”.

John Gruber posted a quick ping yesterday, noting how nicely it works with Beanstalk, to provide a nice end-to-end solution for newbies.

Check out the Versions beta, and decide for yourself.

Update: Be careful about using it with any projects for which you already have version control activated in Xcode… the two apps, for some reason, don’t work in sync. I’m not entirely sure what the problem is, but Xcode will give errors for projects that Versions touches, and isn’t able to sync until you re-checkout the project (using Xcode). Versions also runs every single file, and freaks out when my PPC machine makes an extra or different build file than my Intel machine. Again, I don’t know what it’s doing – only that I’m going to keep using only Xcode for this project until the authors of Versions work to integrate the two programs better.

I also had a problem where my Versioning provider had an out-of-date ssl certificate, and it was throwing an error that required response, but I wasn’t given any way to respond in Versions, so I had to load up the command-line svn first to get around it. Versions needs a way to present possible options/answers to the cryptic errors that svn throws.

Related research and analysis from GigaOM Pro:
Subscriber content. Sign up for a free trial.

• Why iPad 2 Will Lead Consumers Into the Post-PC Era
• The Near-Term Evolution of Social Commerce
• Content Farms: The Players, The Benefits, The Risks