HashiTalks 2025 Learn about unique use cases, homelab setups, and best practices at scale at our 24-hour virtual knowledge sharing event. Register
Vagrant

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