DEV Community

Cover image for Vagrant: Beginner's Guide
Otitoju Mercy
Otitoju Mercy

Posted on

Vagrant: Beginner's Guide

#devops #vagrant #beginners

Have you ever wanted to quickly spin up a new computer environment on your own machine, without all the hassle of setting up everything from scratch? Enter Vagrant—a powerful tool that lets you create and manage lightweight, reproducible, and portable virtual machines. Whether you're a developer, a student, or simply curious about trying out different environments, this guide will walk you through what Vagrant is, how to install it, get started with it, use it, and even clean it up when you're done.

What is Vagrant?
Vagrant is like a recipe for building computer environments. Imagine you had a cookbook that told you exactly how to create the perfect setup for a particular dish every time. In the world of software development, Vagrant uses a file called a Vagrantfile as that recipe. With this file, you can describe everything your virtual machine (VM) needs—like the operating system, software, and network settings. Vagrant then uses a virtualization provider (usually VirtualBox) to create a VM that matches your specifications. Vagrant is an open-source tool that allows you to create, configure, and manage boxes of virtual machines through an easy to use command interface.

Step 1: Installation

Before you can start using Vagrant, you'll need to install a couple of things:

vagrant --version
Enter fullscreen mode Exit fullscreen mode

This command should output the version of Vagrant you installed, confirming that the installation was successful.

Step 2: Pre-Adding the Box

Before you initialize your Vagrant project, you can pre-download (or "add") the box you want to use. Add the Ubuntu Box.

vagrant box add ubuntu/trusty64
Enter fullscreen mode Exit fullscreen mode

This command downloads the ubuntu/trusty64 box to your local system. Once added, Vagrant will recognize it immediately when you initialize your project.

Step 3: Creating Your First Vagrant Project

Now that everything is installed, it’s time to create your first Vagrant project. Follow these steps:

  • Create a Project Directory: Create a folder where your project will live. For example, on Windows you might do this via Command Prompt: 
mkdir "C:\Users\YourUsername\Desktop\my_vagrant_project"
cd "C:\Users\YourUsername\Desktop\my_vagrant_project"
Enter fullscreen mode Exit fullscreen mode

Replace the "YourUsername" with your desktop name

  • Initialize Vagrant: Inside your project directory, initialize a new Vagrant environment by running: 
vagrant init ubuntu/trusty64 --box-version 20191107.0.0
Enter fullscreen mode Exit fullscreen mode

This command creates a Vagrantfile in your folder, check out some other Vagrant Boxes here: [https://portal.cloud.hashicorp.com/vagrant/discover]

Step 4: Starting and Using Your Virtual Machine

With your Vagrantfile in place, you’re ready to bring up your virtual machine.

  • Start the Virtual Machine: In your project directory, run: 
vagrant up
Enter fullscreen mode Exit fullscreen mode

This command will start the VM based on the settings in your Vagrantfile. Since you've already added the Ubuntu box, Vagrant can skip the download step if the box is already present on your system.

  • Connect to the Virtual Machine: Once your VM is up and running, connect to it using: 
vagrant ssh
Enter fullscreen mode Exit fullscreen mode

This command opens a secure shell (SSH) session directly into your VM, allowing you to interact with it just like a regular computer.

  • Stopping the Virtual Machine: This command gracefully shuts down the virtual machine. 
vagrant halt
Enter fullscreen mode Exit fullscreen mode

Step 5: Deleting or Cleaning Up Your Vagrant Environment

When your work is done, you can easily clean up the Vagrant environment.

  • Destroy the Virtual Machine: To completely delete the VM and free up system resources, run: 
vagrant destroy
Enter fullscreen mode Exit fullscreen mode
  • Removing the Vagrantfile If you want to start over with a fresh setup in the same directory, simply delete the Vagrantfile: 
del Vagrantfile
Enter fullscreen mode Exit fullscreen mode

Conclusion

_ With this beginner-friendly walkthrough, you're now ready to explore the world of Vagrant and harness its power to create consistent and portable development environments. Happy Vagrant-ing! THANKS for your TIME!🎉_

Top comments (0)

Read next

msnmongare profile image

Managing a Laravel Admin Panel Across Multiple Client Projects Using Git Submodules

Sospeter Mong'are -

marko_milosavljevic_97169 profile image

Terraform Implicit vs Explicit Dependencies

Marko Milosavljevic -

lovestaco profile image

Speed Up DB Queries Like a Pro

Athreya aka Maneshwar -

mroman7 profile image

Think and Grow as a Senior Developer: A Journey of Curiosity and Mastery

Roman -