===============
Downloading vmm
===============

Current version
---------------
|curr_vers_rel_date|
|rel_hist|

Download a gzip compressed archive
----------------------------------
vmm could be downloaded from the `download page`_ at `SourceForge`_. To
extract the downloaded archive use ``tar xzf vmm-0.6.2.tar.gz``. This will
create the new directory :file:`vmm-0.6.2` in the current working directory.

Verify the downloaded archive
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you have downloaded the archive from the download site you can
optionally verify the integrity_ of this archive.
In order to verify the integrity of the archive you have to download the
corresponding signature file (:file:`vmm-0.6.2.tar.gz.sig`) too.
The signature can be verified using GPG_ or PGP_.
For example to check the signature of the archive :file:`vmm-0.6.2.tar.gz`
you can execute this command ``gpg --verify vmm-0.6.2.tar.gz.sig``.

The tarball was signed by Pascal Volk (ID 0xC51139FE).
Older releases (≦ 0.6.1) were signed with key ID 0xCEC0904E).
You can fetch the public key from a key server using the command
``gpg --recv-keys 0xC51139FE``.

Get vmm from the Mercurial repository
-------------------------------------
To get a tagged clone of the current vmm release from the Mercurial_
repository use:
``hg clone http://hg.localdomain.org/vmm/ -r vmm-0.6.2 vmm-0.6.2``.
This will put the files into the new created directory :file:`vmm-0.6.2`.

When you omit the ``-r vmm-0.6.2`` option, you will get the latest changes
from the `vmm repository`_. This code may work for you or not.

Get vmm from the Git repository
-------------------------------
The Debian project is hosting the `Git repository of vmm
<http://anonscm.debian.org/gitweb/?p=collab-maint/vmm.git>`_.
The *upstream* branch is a mirror of the Mercurial *default* branch.
The *master* branch is for Debian packaging.
In order to clone the *upstream* branch use:
``git clone --branch upstream git://anonscm.debian.org/collab-maint/vmm.git``

Packages
--------
Debian
^^^^^^
Since Debian Wheezy vmm is also `available <http://packages.debian.org/vmm>`_
in the Debian package repository.
The vmm package is `maintained <http://packages.qa.debian.org/v/vmm.html>`_
by Martin F. Krafft.
Take a look at the file :file:`/usr/share/doc/vmm/README.Debian` for Debian
specific modifications.

.. include:: substitutions.rst
.. include:: ext_references.rst