Vagrant is a software application that creates an operating system environment using virtualization technology.
Vagrant uses a command line interface to load, prepare, and launch a virtual environment, called a Vagrant Box. There are many pre-configured Vagrant boxes available for download. You can also start with a basic box and add your own configuration.
This guide will walk you through how to install Vagrant on Ubuntu 18.04 (Bionic Beaver).
- Access to a user account with sudo privileges
- A terminal window / command line (Ctrl-Alt-T)
Steps to Install Vagrant on Ubuntu
VirtualBox is a software utility that allows you to run an operating system inside an operating system. It does this by creating a virtual environment. Since Vagrant creates virtual operating systems, it needs a tool like VirtualBox to manage the virtual operating systems.
In a terminal window, type in the following command to install VirtualBox:
sudo apt install virtualbox
The system should download and install VirtualBox software.
Next, choose one of two ways to install Vagrant.
You can run the
apt-get install command in Ubuntu Linux or download the binary package from Vagrants website.
Option 1: Install Vagrant with apt-get
To Install Vagrant with the
apt-get install command use the following:
sudo apt install vagrant
The system should download and install the software.
Option 2: Install Vagrant With the Binary Package
Sometimes, the version of the software in the official repositories is not as recent as on the developer’s website.
To make sure you are running the latest version of Vagrant, open a web browser and browse to https://www.vagrantup.com/downloads.html. Since Ubuntu is a Debian-based operating system, choose either the 32-bit or 64-bit link under the Debian heading.
Alternately, if you know the version of Vagrant you want to download, enter the following in a terminal window:
sudo wget https://releases.hashicorp.com/vagrant/2.2.2/vagrant_2.2.2_x86_64.deb
Then you can install the package using the following command:
sudo dpkg –i vagrant_2.2.2_x86_64.deb
Note: This version 2.2.2 is current as of the writing of this article. You can find the latest version by checking the developer’s download page.
Verify Vagrant Installation
To verify the installation, use the following command:
The system should display the current version of Vagrant installed on your Ubuntu system.
Deploying Vagrant On Ubuntu 18.04
Now that you have installed Vagrant, let’s create a development environment.
1. Create a new directory to store the virtual operating system you are going to create:
sudo mkdir ~/vagrant-ubuntu
2. Download and install your operating system (Vagrant Box) of choice. For example, this command will install the Trusty Tahr 64-bit system:
sudo vagrant init ubuntu/trusty64
init command loads the virtual operating system. It also creates a default basic configuration file. This is called the Vagrantfile, and it is located in the same directory you just created. This file can be edited and copied to other systems.
3. Next, create and configure the virtual machine according to the Vagrantfile with:
The system should show the default SSH address, username, and authentication method for the new virtual machine.
4. To connect to the virtual machine by SSH, enter the following:
You can now work in the new virtual environment.
Other Vagrant Commands
To stop the virtual machine use:
To delete the virtual machine, use the command:
This will also destroy any work you have done inside the virtual OS.
To manually create a Vagrantfile type in the following command:
This will create a blank Vagrantfile as a placeholder. The
vagrant up command should then launch a default virtual environment. A text editor can also be used to edit the Vagrantfile.
Now, you know how to install and configure Vagrant on your Ubuntu system. You should have a functioning Ubuntu virtual machine managed through Vagrant.