{"id":28318,"date":"2020-02-06T11:44:00","date_gmt":"2020-02-06T09:44:00","guid":{"rendered":"https:\/\/themeisle.com\/blog\/?p=28318"},"modified":"2023-02-06T07:48:00","modified_gmt":"2023-02-06T07:48:00","slug":"vagrant-wordpress","status":"publish","type":"post","link":"https:\/\/themeisle.com\/blog\/vagrant-wordpress\/","title":{"rendered":"How to Set Up a Vagrant WordPress Development Environment"},"content":{"rendered":"\n

There are many ways to set up a local development environment to help you test your new WordPress projects. However, a lot of tools are resource-heavy. On the other hand, setting up a more lightweight testing environment manually can get tricky. Using a Vagrant WordPress “box” can offer a good middle ground between the two.<\/p>\n\n\n\n

In a nutshell, Vagrant lets you set up testing environments with very little overhead. This means you can run several unique environments side by side using different configurations, even on modest hardware.<\/p>\n\n\n\n\n\n\n\n

\n
\n

In this article, we’ll introduce you to Vagrant environments<\/a> and how the box system works. Then we’ll teach you how to set up a Vagrant WordPress environment<\/a>.<\/p>\n\n\n\n

Let’s get to work!<\/p>\n<\/div>\n\n\n\n

\n\t\t
<\/div>\n\t\t\t
\n\t\t \t
\n\t\t \t\t#Vagrant makes local #WordPress development easy \ud83c\udfe0 Here's how to set it up in 3 steps<\/a>\n\t\t \t<\/div>\n\t\t \t
\n\t\t \tClick To Tweet \n\t\t \t\t<\/span>\n\t\t \t<\/a>\n\t\t <\/div>\n\t\t<\/div>\n<\/div>\n<\/div>\n\n\n
<\/div>\n\n\n\n

What Vagrant is (and why it’s an excellent tool for WordPress development) \ud83d\udc68\ud83c\udffb\u200d\ud83d\udcbb<\/h2>\n\n\n\n
\"The<\/figure>\n\n\n\n

At its core, Vagrant<\/a> is a tool for virtual machine management. You can provision machines using VirtualBox<\/a>, VMware<\/a>, and even online services, such as Amazon Web Services (AWS)<\/a>.<\/p>\n\n\n\n

Vagrant works by you using the command line to set up “containers” or “boxes.” You can then configure and interact with these boxes through the command line, as well as use your favorite text editor, browser, and any other tools you have installed on your computer.<\/p>\n\n\n\n

Vagrant environments tend to be very lightweight in comparison to full virtual machines. What’s more, you can quickly set up ready-to-go environments using boxes that other users share \u2013 and there are plenty <\/em>of options to choose from.<\/p>\n\n\n\n

\"Some<\/figure>\n\n\n\n

The best part of using Vagrant is that it’s easy to share your configuration files or boxes with other team members. This means you can all have identical development environments to work on, even if you use a different operating system (OS) or setup.<\/p>\n\n\n\n

When it comes to WordPress, there are a lot of pre-built Vagrant environments you can use. Let’s go over how the process works.<\/p>\n\n\n

<\/div>\n\n\n\n

How to set up a Vagrant WordPress development environment (in 3 steps) \ud83d\udc69\ud83c\udffe\u200d\ud83d\udcbb<\/h2>\n\n\n\n

As we mentioned, Vagrant is a command-line tool available for Linux, Mac, and Windows<\/a>. However, there are a few dependencies you’ll need. Let’s start there.<\/p>\n\n\n\n

    \n
  1. Install VirtualBox and Vagrant<\/a><\/li>\n\n\n\n
  2. Install a Vagrant WordPress box<\/a><\/li>\n\n\n\n
  3. Test your new WordPress local installation<\/a><\/li>\n<\/ol>\n\n\n
    <\/div>\n\n\n\n

    Step 1: Install VirtualBox and Vagrant<\/h3>\n\n\n\n

    Since you’ll use Vagrant locally, you need a program that enables you to set up new virtual machines. VirtualBox is the software Vagrant recommends, and both programs work together out of the box.<\/p>\n\n\n\n

    First, you’ll want to install the appropriate version of VirtualBox<\/a> for your OS. Once the software is set up, go ahead and install Vagrant. When you’re done, open the command line and type in the following:<\/p>\n\n\n\n

    vagrant -v<\/code><\/p>\n\n\n\n

    This is a simple test to see if Vagrant is running correctly. If you don’t see a message confirming the current version of Vagrant installed on your system, reboot your computer and try again.<\/p>\n\n\n\n

    Once you confirm Vagrant is working, it’s time to set up a WordPress environment.<\/p>\n\n\n

    <\/div>\n\n\n\n

    Step 2: Install a Vagrant WordPress box<\/h3>\n\n\n\n

    Instead of setting up a whole environment from scratch, you can get right to work by using a pre-built WordPress configuration. There are a lot of options for Vagrant WordPress boxes, but we recommend you use VCCW<\/a>, which is an environment built for theme and plugin development.<\/p>\n\n\n

    \n
    \"The<\/figure><\/div>\n\n\n

    VCCW comes with Ubuntu, Git version control, the latest version of WordPress, WP-CLI, PHP 7, MySQL, Apache, and much more. In other words, it packs in everything you need.<\/p>\n\n\n\n

    To get started, you’ll need two things:<\/p>\n\n\n\n

      \n
    1. The VCCW Vagrant box<\/li>\n\n\n\n
    2. Its installation files<\/li>\n<\/ol>\n\n\n\n

      First, run the following command in your Terminal or equivalent:<\/p>\n\n\n\n

      vagrant box add vcc-team\/xenial64<\/code><\/p>\n\n\n\n

      Now download the latest configurations instructions<\/a> for your new Vagrant WordPress environment. It weighs less than 20 Kb, which shows how easy it is to replicate environments using Vagrant.<\/p>\n\n\n\n

      Once you have the files, set up a new local directory for your environment and move the zip <\/em>file inside. Next, move into this environment using the command line (replacing the placeholder text we’ve used):<\/p>\n\n\n\n

      cd nameofthenewdirectory<\/code><\/p>\n\n\n\n

      When you’re inside the environment in the command line, type in the following:<\/p>\n\n\n\n

      vagrant up<\/code><\/p>\n\n\n\n

      The vagrant up<\/em> command tells your new virtual machine to start using the instructions from the file inside its directory. Since this is the first time your machine spins up, it can take a while for Vagrant to set everything up. Subsequent starts will go by much faster.<\/p>\n\n\n\n

      Once your Vagrant WordPress box is ready, you’ll be able to use the command line again and test if everything is working correctly.<\/p>\n\n\n

      <\/div>\n\n\n\n

      Step 3: Test your new WordPress local installation<\/h3>\n\n\n\n

      Once your VCCW box is up, you should be able to access it from your browser using either of these addresses:<\/p>\n\n\n\n

        \n
      1. http:\/\/vccw.test<\/code><\/li>\n\n\n\n
      2. http:\/\/192.168.33.10<\/code><\/li>\n<\/ol>\n\n\n\n

        If everything’s working correctly, you’ll be able to log into WordPress using “admin” as both your username and password. This is not a combination we’d recommend under normal circumstances, but for a local testing environment, it’s not a big issue.<\/p>\n\n\n\n

        As we touched on, VCCW automatically sets up a MySQL database for your local website. To access it, you can go to 127.0.0.1<\/code> on port 3306<\/code> through your browser. These are the default login credentials:<\/p>\n\n\n\n