How to Install Subversion on Mac OS X

• 740,518 views
• 17 Editors
• Edited 8 days ago

Two Parts:Install From a Binary PackageSet Up Your Subversion Environment

Subversion, sometimes called SVN, is an open-source system that remembers every change made to your files and directories. It can be helpful if you‘d like to track how your documents have changed over time or to recover an older version of a file. Start at Step 1 for detailed instructions for installing Subversion on Mac OS X.

Part 1 of 2: Install From a Binary Package

1. 

   1

   Navigate to http://subversion.apache.org/packages.html#osx. There you will find a number of binaries that you can download, each having various requirements. Pick the one most appropriate for your needs.

   Ad

2. 

   2

   Unzip the .pkg file. It should create a Subversion installer on your desktop. Double click that file, and follow the installation steps as directed.

3. 

   3

   Open the Terminal, located in the Utilities folder. Alternately, search in Spotlight for Terminal. Enter the following at the [username]$ prompt:

   • svn [enter]
     
     
   • If that returns "Type ‘svn help‘ for usage," then svn is working correctly.
     
     
   • If /usr/local/bin is not in your path, edit your .profile and add a line like the following:
     
     
     • export PATH=$PATH:/usr/local/bin
   • Open another Terminal window and try again with: svn [enter]
     
     

Part 2 of 2: Set Up Your Subversion Environment

1. 

   1

   Set up an SVN server. You will need this to distribute a Subversion project.

2. 

   2

   Launch Terminal, then create a directory called svnroot in your account directory, as follows: mkdir svnroot

   • Type: svnadmin create /Users/[your username]/svnroot
     
     
   • That creates your server!
     
     
3. 

   3

   Use the svn server with Terminal. You can checkout in the terminal with this command: svn checkout file:///Users/[your username]/svnroot

   • For remote access, enable "ssh access" (in System Preferences/Sharing) and checkout with: svn checkout svn+ssh://my.domain.com/Users/[your username]/svnroot
     
     
4. 

   4

   Set up a Subversion client. For example, svnX supports all current versions of Mac OS X from 10.5 to 10.8. You can get it at http://code.google.com.

5. 

   5

   After the download, start SVNx and you will see two windows namedWorking Copies and Repositories. Under Repositories, add the URL und Login Data from the SVN Server.

   • Open the window; if you get an error, check the LogIn.
     
     
   • Switch to the Terminal and type: svn import -m "your Import message" /my/local/project/path /my/remote/svn/repository This command adds all files from the local Project to the SVN Server.
     
     
   • Add the path of your SVN repository (from the SVN server) to the list in the Working Copy window in SVNx.
     
     
6. 

   6

   In SVNx open your working copy. When you‘re working on this Project, you will see your modifications here.

7. 

   7

   Test it. Make a small modification on your working copy, then refresh the the Working Copy window.

   • SVNx displays all files with modifications. Press the Commit button to add it to the SVN Server Repository.
8. 

   8

   If you prefer to work on the Subversion repository directly from the Finder, consider using either SCPlugin or SVN Scripts for Finder.

   Ad

We could really use your help!

Can you tell us about
pest control?

Yes I can

Can you tell us about
recruitment?

Yes I can

Can you tell us about
shamanism?

Yes I can

Can you tell us about
iPads?

Yes I can

Tips

• Various additional documentation exists in the doc/ subdirectory of the Subversion source. See the file doc/README for more information.
• The primary documentation for Subversion is the free book Version Control with Subversion, a.k.a. "The Subversion Book." You can get it from http://svnbook.red-bean.com/

Ad

Related wikiHows

How to 
Get Current Date in Asp.Net

How to 
Install Subversion on Windows 7

How to 
Personalize Your Mac OS X Desktop

How to 
Install Snak IRC Program for Mac OS X

How to 
Stop an Application from Opening at Startup With Mac OS X

How to 
Burn a CD Using Mac OS X

How to 
Make a DMG File on a Mac

Sources and Citations

• Version Control with Subversion - The Subversion Book
• [http:// weblogs.asp.net/fmarguerie/archive/2005/04/27/404793.aspx SVN Servers] - A SVN Server List
• O‘REILLY MacDevCenter Subversion Tutorial
• VersionsSystems A SVN Linklist

Article Info

Categories: Mac OS X

Recent edits by: Yoko Kanai, WanderWoman, Anuj_Kumar1

In other languages:

Espa?ol: Cómo instalar Subversión en Mac OS X, Português: Como Instalar o Subversion no Mac OS X, Italiano: Come Installare Subversion su Mac OS X, Русский: установить Subversion на Mac OS X, Deutsch: Subversion unter Mac OS X installieren