hashicorp /vagrant
Vagrant is a tool for building and distributing development environments.
★ 27,231⑂ 4,491👁 702⑃ 4,050● 9,658▤ 191
27,231
stars
4,491
forks
702
watchers
4,050
prs
9,658
issues
191
releases
README
Vagrant
[!IMPORTANT]
HCP Vagrant is in the process of being deprecated and limited features will be available from the community edition effective November 2, 2026. Click here for more information.
This change is only for HCP Vagrant and does not apply to Vagrant CLI.
- Website: https://www.vagrantup.com/
- Source: https://github.com/hashicorp/vagrant
- HashiCorp Discuss: https://discuss.hashicorp.com/c/vagrant/24
Vagrant is a tool for building and distributing development environments.
Development environments managed by Vagrant can run on local virtualized
platforms such as VirtualBox or VMware, in the cloud via AWS or OpenStack,
or in containers such as with Docker or raw LXC.
Vagrant provides the framework and configuration format to create and
manage complete portable development environments. These development
environments can live on your computer or in the cloud, and are portable
between Windows, Mac OS X, and Linux.
Quick Start
Package dependencies: Vagrant requires bsdtar and curl to be available on
your system PATH to run successfully.
For the quick-start, we'll bring up a development machine on
VirtualBox because it is free and works
on all major platforms. Vagrant can, however, work with almost any
system such as OpenStack, VMware, Docker, etc.
First, make sure your development machine has
VirtualBox
installed. After this,
download and install the appropriate Vagrant package for your OS.
To build your first virtual environment:
vagrant init hashicorp/bionic64
vagrant up
Note: The above vagrant up command will also trigger Vagrant to download the
bionic64 box via the specified URL. Vagrant only does this if it detects that
the box doesn't already exist on your system.
Getting Started Guide
To learn how to build a fully functional development environment, follow the
getting started guide.
Installing from Source
If you want the bleeding edge version of Vagrant, we try to keep main pretty stable
and you're welcome to give it a shot. Please review the installation page here.
Contributing to Vagrant
Please take time to read the HashiCorp Community Guidelines and the Vagrant Contributing Guide.
Then you're good to go!Top issues
#11853Vagrant CLI on Windows is very slow79 comments · 2020-08-26#12518Provider for UTM (VM for M1 processors)52 comments · 2021-09-11#8384Discussion: Static IP address for Hyper-V50 comments · 2017-03-17#11020vagrant-libvirt doesn't start VM F3042 comments · 2019-08-12#12760Provider for Tart (VMs on Apple Silicon)36 comments · 2022-05-11#10601new ssh config directive "include" breaks "vagrant ssh"35 comments · 2019-01-18#10826Vagrant 2.2.4 fails to install vagrant-vbguest plugin31 comments · 2019-05-05#12330mount.nfs: access denied by server while mounting. External drive/volume. macOS 11.330 comments · 2021-04-27
Latest release
v2.4.9 v2.4.9 2025-08-21CHANGELOG: https://github.com/hashicorp/vagrant/blob/v2.4.9/CHANGELOG.md