Skip to content

Vagrant Installation Guide

This guide walks you through installing Vagrant on your local machine. Vagrant is a tool for building and managing virtual machine environments in a single workflow.

📦 Prerequisites

Before installing Vagrant, make sure you have:

  • VirtualBox or another supported provider
  • A supported operating system:
  • Windows
  • macOS
  • Linux

🛠 Installation Steps

Windows

  1. Download the Vagrant installer from the official Vagrant website.
  2. Run the installer and follow the prompts.
  3. After installation, restart your system (recommended).
  4. Verify the installation:
vagrant --version

macOS

brew install --cask vagrant

Manual Install

  1. Download the macOS .dmg installer from the Vagrant downloads page.
  2. Open the file and drag Vagrant into your Applications folder.
  3. Verify:
vagrant --version

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install -y vagrant

Or download the .deb file from downloads and install:

sudo dpkg -i vagrant_x.x.x_x86_64.deb

✅ Verifying Installation

Run the following command in your terminal:

vagrant --version

You should see the installed version number.

🚀 Next Steps

  • Learn how to initialize your first Vagrant project. [TODO: Next chapter]
  • Check the Vagrantfile reference for configuration options.

📚 Resources