We use Apache Subversion for version control. You can browse our repository in your web browser.

Getting the source code

The instructions on this page will help you get started using command line tools. If you prefer to work in an IDE then we have separate instructions for you.

Git access

git clone https://git-wip-us.apache.org/repos/asf/rave

Building and Running

To build from source code:


  • Sources compilation require Java SE 6 or higher.
  • The project is built with Apache Maven 3+ (version 3.0.3 or later is required) Download and install

Apache Rave Project

To build the Apache Rave project invoke maven from the project root directory:

mvn install

If you have any problems relating to the rave-master project, see the "Apache Rave Master Project" section at the end of this document.

If Maven can't find the artifacts oauth-httpclient4 or caja, you are probably behind a Maven proxy (repository manager) that doesn't know about the corresponding repositories. Rave depends transitively on these artifacts via Shindig. Shindig, thus adds repositories via their pom.xml files. If your proxy doesn't know about these repositories you have to add these URLs in your proxy-configuration:


Deploying and Running on Tomcat

To run a local Tomcat instance with rave-shindig and rave-portal and Wookie deployed:

  • navigate to the rave-portal subdirectory and invoke:

    mvn cargo:run

    If you are behind a proxy, then you can specify it with the following command

mvn -Dcargo.args="-Dhttp.proxyHost=PROXYHOST -Dhttp.proxyPort=PROXYPORT -Dhttp.nonProxyHosts=NONPROXYHOST" cargo:run

  • open url http://localhost:8080/portal in a browser
  • press Ctrl-C in the console to stop Tomcat again

Logging in

Once the server is running:

  • localhost:8080/portal
  • login as one of the following test users (password is same as username)
    • canonical (this user has admin rights)
    • john.doe
    • jane.doe
    • johnldap
    • OpenID: http://rave2011.myopenid.com/ (password rave2011)

Apache Rave Master Project

The Apache Rave project depends on the separate Apache Rave Master project which defines general and global settings for the whole of the Apache Rave project, independent of a specific release. As its rave-master-pom is already published to the Apache Snapshots repository, there is no need to check it out manually and build it locally yourself, unless changes are needed on general and global level.

If so needed, the Apache Rave Master project can be checked out from:

  http://svn.apache.org/repos/asf/rave/rave-master-pom/trunk rave-master-pom.

After check out, cd into rave-master-pom and invoke maven to install it using:

  mvn install

Running the integration tests

See the article about integration tests