vagrant/website/docs/source/v2/getting-started/index.html.md

1.5 KiB

sidebar_current
gettingstarted

Getting Started

The Vagrant getting started guide will walk you through your first Vagrant project, and show off the basics of the major features Vagrant has to offer.

Before diving into your first project, please install Vagrant. And if you're curious what benefits Vagrant has to offer, you should also read the "Why Vagrant?" page.

The getting started guide will use Vagrant with VirtualBox, since it is free, available on every major platform, and built-in to Vagrant. After reading the guide though, don't forget that Vagrant can work with many other providers.

Up and Running

$ vagrant init precise32 http://files.vagrantup.com/precise32.box
$ vagrant up

After running the above two commands, you'll have a fully running virtual machine in VirtualBox running Ubuntu 12.04 LTS 32-bit. You can SSH into this machine with vagrant ssh, and when you're done playing around, you can remove all traces of it with vagrant destroy.

Now imagine every project you've ever worked on being this easy to set up.

With Vagrant, vagrant up is all you need to work on any project, to install every dependency that project needs, and to setup any networking and synced folders so you can continue working from the comfort of your own machine.

The rest of this guide will walk you through setting up a more complete project, covering more features of Vagrant.