5093f3120e
This is a big commit, and I apologize in advance for the future
git-blames all pointing to me. This commit does a few things:
1. Merges the website/docs and website/www repo into a single website repo
to be in line with other HashiCorp projects
2. Updates to use middleman-hashicorp
3. Converts less to scss to be in line with other projects
4. Updates page styles to be in line with other projects
5. Optimizes images
6. Prepare for S3 + Fastly deployment with scripts, etc.
7. Removes blog posts (they have been transferred to hashicorp.com with
redirects in place
8. Updated sitemap generation script for better SEO
9. Fixed many broken links
10. Add description to all fields
62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Getting Started"
|
|
sidebar_current: "gettingstarted"
|
|
description: |-
|
|
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.
|
|
---
|
|
|
|
# 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.
|
|
|
|
If you are curious what benefits Vagrant has to offer, you
|
|
should also read the ["Why Vagrant?"](/docs/why-vagrant/) page.
|
|
|
|
The getting started guide will use Vagrant with [VirtualBox](https://www.virtualbox.org),
|
|
since it is free, available on every major platform, and built-in to
|
|
Vagrant. After reading the guide though, do not forget that Vagrant
|
|
can work with [many other providers](/docs/getting-started/providers.html).
|
|
|
|
Before diving into your first project, please [install the latest version of Vagrant](/docs/installation/).
|
|
And because we will be using [VirtualBox](https://www.virtualbox.org) as our
|
|
provider for the getting started guide, please install that as well.
|
|
|
|
<div class="alert alert-block alert-info">
|
|
<strong>More of a book person?</strong> If you prefer to read a physical
|
|
book, you may be interested in
|
|
<a href="https://www.amazon.com/gp/product/1449335837/ref=as_li_qf_sp_asin_il_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1449335837&linkCode=as2&tag=vagrant-20" class="alert-link">
|
|
Vagrant: Up and Running</a>, written by the author of Vagrant and published by O'Reilly.
|
|
</div>
|
|
|
|
## Up and Running
|
|
|
|
```
|
|
$ vagrant init hashicorp/precise64
|
|
$ vagrant up
|
|
```
|
|
|
|
After running the above two commands, you will have a fully running
|
|
virtual machine in [VirtualBox](https://www.virtualbox.org) running
|
|
Ubuntu 12.04 LTS 64-bit. You can SSH into this machine with
|
|
`vagrant ssh`, and when you are done playing around, you can terminate the
|
|
virtual machine 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 set up any
|
|
networking or 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.
|
|
|
|
## Next Steps
|
|
|
|
You have just created your first virtual environment with Vagrant. Read on to
|
|
learn more about [project setup](/docs/getting-started/project_setup.html).
|