Skip to main content

CVS Repository Setup in Eclipse


Individuals who wish to set up CVS repositories in the Eclipse IDE.


To use one or more CVS repositories from within the Eclipse IDE.


  • Installed Eclipse IDE: cf. Eclipse on Windows instructions on this site.
  • Login to CVS server: You'll need a login on the server where your CVS repository is hosted.
  • Public Key Login: Exchange public keys with the CVS server you will use from within Eclipse, to allow access to the repository (or repositories) unencumbered by authentication dialogs. To do so (or to test whether this is already done), follow these local instructions, applying them to your CVS server (e.g., or

Setting up CVS in Eclipse

Configure CVS connection

These instructions are written for developers using the CVS server on, but may be a useful model for those connecting to other repositories and/or other servers.

  • If you haven't done so already in the course of going through the Eclipse tutorials, identify the CVS repository (or repositories) you'll be using. The example in these instructions shows how to set up access to the respository, from which a Streek developer on the Berkeley campus will be able to check out files critical to J2EE development (e.g., the ist-jxde tree)
  • Set up CVS preferences for connecting to the repository using SSH, by navigating to Window:Preferences and performing the following steps:
    • Open the Preferences tree to view the pane for Team:CVS:Ext Connection Method
      • The CVS RSH command setting should be ssh2.exe where it is installed on your file system (e.g., C:\Program Files\SSH Communications Security\SSH Secure Shell\ssh2.exe)
      • The Parameters setting should be: -l {user} {host} [note: the parameter following the hyphen is a lower-case ell ("L")]
      • The CVS SERVER setting should be: cvs
      • If you skipped exchanging SSH public keys with, do so now!

Set up CVS repository locations

  • Go to Eclipse's CVS Perspective (Window:Open Perspective:CVS Repository Exploring)
  • Right-click to set up a New:Repository Location
  • Fill in the blanks:
    • Host (example):
    • Repository path (example): /usr/local/cvsrep/org/ist
    • User: yourUserIdHere
    • Password: leave this field blank ... no need to supply password if you exchanged public keys with CVS host
    • Connection type: ext
    • Use Default Port: selected
    • Valildate Connection On Finish: checked
  • Click the Finish button; if the dialog was filled in properly, you'll see a new repository location in the CVS Perspective
  • Other repositories that may be of interest to Streek developers include:
    • /usr/local/cvsrep/org/sis
    • /usr/local/cvsrep/proj/streek
    • /usr/local/cvsrep/third-party/misc
    • /usr/local/cvsrep/third-party/apache
    • /usr/local/cvsrep/third-party/jboss
    • /usr/local/cvsrep2/berkeley/streek

Configure CVS file mappings

As delivered, Eclipse's CVS client is ignorant of the nature (ASCII or Binary) of certain types of files that you may wish to check into the repository. It is very important that you identify file types correctly rather than check in files of unknown types.

Navigate to Windows : Preferences : Team : File Content to view the known file mappings. It is a good idea to add at least the following in addition to the defaults:

  • *.bat (ASCII Text)
  • *.csh (ASCII Text)
  • *.css (ASCI Text)
  • *.dtd (ASCII Text)
  • *.ehtml (ASCII Text)
  • *.ent (ASCII Text)
  • *.jsp (ASCII Text)
  • *.ksh (ASCII Text)
  • *.macrodef (ASCII Text)
  • *.sh (ASCII Text)
  • *.sql (ASCII Text)
  • *.tld (ASCII Text)
  • *.xhtml (ASCII Text)
  • *.xmap (ASCII Text)
  • *.xmi (ASCII Text)
  • *.xsd (ASCII Text)

Check out projects from CVS

The following suggests pertain to Streek developers on the UC Berkeley campus who will be developing software on the Java platform.

Minimally, Streek developers should check out the ist-jxde project (instructions given below). The maven-repo-j5 project is needed by developers building with released versions of streek jar files, and/or those building applications that compile/run on Java 5. Those who still require local builds of Streek from source should check that project out. The current application server used in Streek projects is another basic dependency (as of 07.19.2006, the current app server is jboss-4.0.3, in the canvas repository usr/local/cvsrep/third-party/jboss; those still maintaining apps that run on Java 1.4 will more likely be using jboss-3.2.5). Other check-outs and repositories may be appropriate depending on the project(s) in which each developer will participate.

Note that if you wish to specify a project's type (e.g., for a Java Project - one with Java code in the source tree, such as Streek), and are downloading it into the local workspace for the first time, you should use the CVS check-out option: Check out as project configured using the New Project Wizard.

Example: to check out the ist-jxde tree from the repository usr/local/cvsrep/org/ist:

  • Go to Eclipse's CVS Perspective (Window:Open Perspective:CVS Repository Exploring)
  • Open the HEAD tree in the org/ist repository.
  • Right click ist-jxde and select the option: Check out as project in the workspace
  • Call the project ist-jxde if asked for a project name.
  • Watch the files fly by...