icinga2/doc/9-vagrant-demo-vm.md

# <a id="vagrant"></a> Vagrant Demo VM

The Icinga 2 Git repository contains support for [Vagrant](http://docs.vagrantup.com/v2/)
with VirtualBox. In order to build the Vagrant VM first you will have to check out
the Git repository:

    $ git clone git://git.icinga.org/icinga2.git

Once you have checked out the Git repository you can build the VM using the
following command:

    $ vagrant up

> **Note**
>
> Vagrant and VirtualBox are available for various distributions. Please note
> that Vagrant version `1.0.x` is not supported. At least version `1.2.x` is
> required to be installed (for example from [http://downloads.vagrantup.com](http://downloads.vagrantup.com)).

The Vagrant VM is based on CentOS 6.4 and uses the official Icinga 2 RPM
packages from `packages.icinga.org`.

In addition to installing Icinga 2 the Vagrant script also installs the Icinga
1.x Classic UI and the check plugins that are available from the Monitoring Plugins
project.

The Classic UI is available at [http://localhost:8080/icinga](http://localhost:8080/icinga).
By default both the username and password are `icingaadmin`.

An instance of icinga-web is installed at [http://localhost:8080/icinga-web](http://localhost:8080/icinga-web).
The username is `root` and the password is `password`.

SSH login is available using `vagrant ssh`.