vagrant.rst

title:	Installing Deis on Vagrant
description:	How to provision a multi-node Deis cluster on Vagrant

Vagrant

Vagrant is a tool for building complete development environments with a focus on automation. This guide demonstrates how you can stand up a Deis cluster for development purposes using Vagrant.

Please :ref:`get the source <get_the_source>` and refer to the Vagrantfile while following this documentation.

Install Prerequisites

Please install Vagrant v1.6.5+ and VirtualBox.

The Vagrantfile requires the plugin vagrant-triggers. To install the plugin run:

$ vagrant plugin install vagrant-triggers

Note

For Ubuntu users: the VirtualBox package in Ubuntu has some issues when running in RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's website.

Generate SSH Key

Generate a New Discovery URL

Boot CoreOS

Start the CoreOS cluster on VirtualBox. From a command prompt, switch directories to the root of the Deis project and type:

$ vagrant up

This instructs Vagrant to spin up 3 VMs. To be able to connect to the VMs, you must add your Vagrant-generated SSH key to the ssh-agent (deisctl requires the agent to have this key):

$ ssh-add ~/.vagrant.d/insecure_private_key

Configure DNS

For convenience, we have set up a few DNS records for users running on Vagrant. local3.deisapp.com is set up for 3-node clusters and local5.deisapp.com is set up for 5-node clusters.

Since local3.deisapp.com is your cluster domain, use local3.deisapp.com anywhere you see example.com in the documentation.

It is not necessary to configure DNS for Vagrant clusters, but it is possible - if you want to set up your own DNS records, see :ref:`configure-dns` for more information.

Install Deis Platform

Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to start installing the platform.