Development Environments Made Easy

Install
Tutorials
Documentation

What is Vagrant?

Vagrant is the command line utility for managing the lifecycle of virtual machines. Isolate dependencies and their configuration within a single disposable and consistent environment.

Learn more about Vagrant features

Getting Started

Use Vagrant to create and configure a reproducible and portable work environment.

CLI Quick Start

HCP Vagrant Registry

Virtual boxes for Linux, Laravel and any development environment

Try HCP Vagrant Registry for free

Fundamentals

Boxes
The package format for Vagrant environments - create your own or use one from the public catalog.
Install and Specify a Box
Use a base image to quickly clone a virtual machine.

Vagrantfile
Describe your virtual machine's configuration and how to provision it.
Create a Vagrantfile
Begin your Vagrant project by creating a Vagrantfile.

vagrant up
Create and configure your virtual machine with the single most important Vagrant CLI command.
Boot an Environment
Start your virtual machine with vagrant up.

Important Concepts

Synced Folders
Sync files from your host machine to the guest machine.
Synchronize Your Files
Vagrant automatically syncs files to and from the guest machine allowing you to edits files locally and run them in your virtual machine.

Networking
Access your virtual machines through the high-level networking set up by Vagrant.
Configure Your Network
Forward network traffic from your local machine to your virtual guest machine running on Vagrant.

Additional Reading

Plugins
Add additional functionality to Vagrant via plugins.
Providers
Manage other types of machines via providers.
Triggers
Execute commands on your system before or after Vagrant operations.
Vagrant Share
Share your Vagrant environment with anyone via a single command.

Use Cases with Vagrant

The Nomad Autoscaler
Try out the autoscaling feature of HashiCorp Nomad in a Vagrant environment.
Data Encryption in Vault
Try out data encryption in a Java application with HashiCorp Vault in a Vagrant environment.

Contributing to Vagrant

HashiCorp has some community guidelines to ensure our public forums are a safe space for everyone. When contributing to Vagrant, please respect the same guidelines.

Learn More

Vagrant vs. Other Software

Vagrant is not the only tool to manage virtual machines and development environments.

CLI Tools
Docker
Terraform