[[PageOutline]]

= Quickstart =

We advise to install CMT in its own virtual environment, by using a combination of [http://www.pip-installer.org/ pip], [http://www.virtualenv.org/ virtualenv] (and [http://www.doughellmann.com/docs/virtualenvwrapper/ virtualenvwrapper]). The next section quickly gives you an example of how to setup such an environment. More detailed instructions can be found on the pages of these projects.



= Prepare Environment =

CMT utilizes a PIP package for easy installation. The advantage is that PIP handles all dependencies needed to use CMT. To install the package, you therefor first might need to install the PIP package manager.


== Mandatory dependencies ==

There are several ways to install PIP.

 Using YUM package manager (RHEL)::
   {{{yum install python-setuptools && easy_install pip }}}
 Using aptitude package manager (Debian)::
   {{{aptitude install python-pip}}}
 Using easy_install::
   {{{easy_install pip}}}
 Using the (most recent) installer::
   {{{curl http://python-distribute.org/distribute_setup.py | python}}}


== Optional dependencies ==

The following are optional, but can be quite useful.

=== Virtualenv ===

Virtualenv, amongst other things, allows you to install (PIP / Python) packages in alternative locations and create complete (Python) environments.
{{{
pip install virtualenv
}}}

=== Virtualenv wrapper ===

These are a collection of useful wrapper scripts to make using virtual environments easy. At this time there seems to be no RPM available in the CentOS repository (RB: 14th May 2012)
{{{
pip install virtualenvwrapper
}}}

= Install CMT =

After the initial release of CMT, it will be available as a download. More about this soon..

Once you've downloaded the package, CMT can be easily installed with `pip`, by issuing
{{{
pip install <CMT-packagename>
}}}

Keep in mind that CMT not only requires other Python-packages, but some development packages with headers for Python and PostgreSQL libraries too.
So, if you're facing any difficulties when installing CMT, make sure to check your system for the [wiki:WikiStart#Requirements required packages].

After installing, you have to modify the sample config file `cmt.conf.sample` to reflect your settings and then rename it to `cmt.conf`.