Cipango can either be installed from a [#binary release] or [built from the trunk source code|#Build from Source Code]. 

h2. Binary Release

h3. Cipango releases

Cipango is distributed as a platform independent zip file containing a Jetty and Cipango bundle ready to start. The most recent distribution can be downloaded from {link-window:href=http://code.google.com/p/cipango/downloads/list}google code{link-window}. 

h3. Installing from the Cipango/Jetty bundle

All you need to do is to unzip the archive. The top level directory is a standard [Jetty installation|http://wiki.eclipse.org/Jetty/Starting/Downloads]. The only difference is that there is a {{sipapps}} directory in addition to {{webapps}}. This directory is used to deploy SIP or converged application.

Your top-level directory, referred to as {{$\{jetty.home\}}} in this documentation should then look like:

{code:bash}
$ ls
LICENSE-APACHE-2.0.txt          etc
LICENSE-ECLIPSE-1.0.html        lib
META-INF                        logs
NOTICE-CIPANGO.txt              notice.html
README-CIPANGO.txt              overlays
README.txt                      resources
VERSION-CIPANGO.txt             sipapps
VERSION.txt                     start-cipango.ini
about.html                      start.ini
bin                             start.jar
contexts                        webapps
contexts-available
{code}

h2. Build from Source Code

h3. Getting source code

Cipango source code is available at [http://code.google.com/p/cipango/source/checkout]. Use the following command to anonymously check out the latest project source code to a directory named {{cipango}}:

{code}svn checkout http://cipango.googlecode.com/svn/trunk/ cipango{code}

h3. Building

Cipango uses [Maven|http://maven.apache.org] (v2.2.0 or later) as its build system. To build just go to the cipango top source directory and type:
{code}mvn install{code}

The [Cipango Maven Plugin] needs {{svn}} and {{patch}} commands available on the path.
If these commands are not installed on your system, you may install them as follows: 
* subversion: [http://subversion.tigris.org/getting.html] or {{aptitude install subversion}} on linux
* patch:
** Windows: [http://gnuwin32.sourceforge.net/packages/patch.htm]
** Linux: {{aptitude install patch}}

When the build is completed, you'll find binary release of cipango packaged as {{.zip}} and {{.tar.gz}} under the {{cipango-distribution/target}} directory. You can now install the binary release as explained above.