Running WordPress Locally with Vagrant and VVV

Running WordPress Locally with Vagrant and VVV

My subsequent sequence of posts are going to cowl a myriad of the way to run WordPress domestically to your growth wants. Over the years I’ve used every possibility at totally different instances relying on the wants for my native growth atmosphere.

Today we’re going to have a look at one of many first instruments that I dug into as I realized extra about server configuration and working with WordPress Core code, Varying Vagrant Vagrants. That’s a little bit of a mouthful, so it’s most frequently abbreviated to VVV, which is what I’ll use.

What is VVV

VVV was began as an inside venture at a WordPress company referred to as 10up. As it grew in recognition it was moved out of a company-specific venture and an official group was set as much as govern the venture. Since then a vibrant neighborhood of builders has continued to keep up and use VVV of their growth atmosphere.

VVV is predicated on Vagrant, which is open supply software program used to construct digital machines. You mix it with instruments like VirtualBox, Hyper-V, Docker, or other supported platforms to run digital computer systems in your machine.

Most folks use VirtualBox to work together with Vagrant, and VVV is about as much as count on VirtualBox by default.

Installing VVV

Let’s begin by getting the default instruments arrange in order that we are able to set up VVV. First, head to the Vagrant downloads page and obtain the model that’s meant to your pc.

On macOS, the obtain incorporates a package deal file that must be double-clicked to put in. You’ll be requested to your password and then the set up will likely be full.

Running WordPress Locally with Vagrant and VVV xEQJEpV8O1BMigouLlAriIGp duEsdu7PZE1wEw HJdBIzxAwxdSBki7J2SFfEN 1dGus rxKTowpzaC8XeOG7iupIwp ZAroEzf9JomRIaZvX2M4VB8S15UcRTIZr 9ccyWRQy9

For VirtualBox, head to the download page and obtain the model that’s meant to your pc. For macOS, you’ll be trying on the similar primary course of. Double-click the package deal file to run it then enter your password when prompted and let the installer run.

Running WordPress Locally with Vagrant and VVV

Note: You might must reboot your machine when you’ve put in VirtualBox to get all of the community connections working. If it doesn’t work at first, flip it off and on once more earlier than you go additional down the trail of troubleshooting.

Now we’re prepared to put in VVV. While there are two strategies to put in VVV, we’re going to stay with the straightforward methodology by way of git. Check out our Introduction to Git for those who’re not acquainted with easy methods to use it.

First, create a listing to retailer all of your VVV websites, I normally use ~/Sites. Then we’ll want to make use of git to clone the VVV repository with the command under.

git clone -b secure git:// ~/Sites/vagrant-nexcess

This creates a replica of the present secure department of VVV in a folder referred to as vagrant-nexcess in our present listing. Next, you’ll want to vary into the vagrant-nexcess listing by utilizing the cd vagrant-excess command. Once inside this listing use vagrant as much as begin working VVV.

If you’re on Windows, you’ll want to make use of a command prompt with administrator privileges to get customized hostnames working with VVV.

It might take some time the primary time you put in this as a result of it has to obtain a replica of the digital machine that’s outlined within the VVV configuration recordsdata, however after the primary time, that knowledge is cached so future installs will likely be a lot sooner.

You might get requested to put in another plugins for Vagrant just like the vagrant-goodhosts plugin. You need all these things so settle for the installs when prompted. You might must run the vagrant up command once more after you’ve put in the plugins, and chances are you’ll must enter your administrator password to change the hosts file so you may have customized domains accessible in VVV.

All computer systems have a hosts file, which maps hostnames to IP addresses. When you sort in nexcess.web this file is a part of the system that can translate that URL into the IP tackle that your pc is in search of. By including a website to your hosts file, you may power that area to go to wherever you need.

Running WordPress Locally with Vagrant and VVV yrpflsC7x1u303dOJXNlSTiiTnlIp bxtlQpC7XxldvF9vdEZPE7R2 Dob1wpLjYmFgOsaC6JOtA5ojEls9SQ5ZC3oKDgfGXJYrvGlaQaJjHYnZle0w6tUYHnb8hNwM0UlUuctOD

Now that VVV is put in you may entry the default website on the default URL of http://vvv.test.

Now, let’s go over easy methods to add a customized area and a clear WordPress set up to VVV so you may get began with a brand new venture. To begin, open the vagrant-nexcess folder in your code editor. Then you’ll must open config/config.yml so as to add our new area. We’re going to create a brand new website referred to as nexcess and use nexcess.take a look at as our growth area.

Inside config.yml you may already see some additional websites configured. Let’s take a look at the primary one to know what’s occurring.

 # newest model of WordPress, can be utilized for shopper work and testing

  # Check the readme at


    skip_provisioning: false

    description: "A standard WP install, useful for building plugins, testing things, etc"



      - one.wordpress.take a look at



        WP_DEBUG: true

        WP_DEBUG_LOG: true

        WP_DISABLE_FATAL_ERROR_HANDLER: true # To disable in WP 5.2 the FER mode

First, we identify the profile wordpress-one and underneath that, we set our configurations for this website. We can see that we give the location an outline, and use the repo parameter to outline the place we wish to clone the location from. Then we arrange the host and outline a number of the constants that will likely be current in our commonplace wp-config.php file for debugging. You might even go to at least one.wordpress.take a look at and see the location that’s configured by default.

Modify the code above to match the modifications made under. Note, we modified the identify of the profile, the outline, and host, and we added a plugin we would like put in by default, Query Monitor.


    skip_provisioning: false

    description: "A standard WP install, useful for building plugins, testing things, etc"



      # locale: it_IT

      delete_default_plugins: true


        - query-monitor


      - nexcess.take a look at

Once you’ve made the modifications above, head over to your terminal and run vagrant up –provision to inform Vagrant to run by its setup scripts once more and provision the digital server with our new settings. Then you could find your new website at nexcess.take a look at.

A phrase of warning, the configuration file is written in YAML and YAML is delicate to indentation. You ought to be utilizing 2 areas to indent issues or it would all go up in flames.

If you adopted our sequence on Unit Tests then you definately’ll wish to run them with VVV. Because VVV is working a digital server you’ll want to start out by utilizing ssh to hook up with this digital server. You can do that with the vagrant ssh command that’s supplied as a part of your package deal.

Next, you’ll want to make use of terminal to get to your net listing, which is discovered at /srv/www. From right here you may transfer to the listing that has your exams and run them like regular. 

Another factor that I usually must do is join on to the database of the location I’m engaged on. If you’re utilizing Sequel Pro, VVV comes bundled with a configuration file you should use to attach mechanically. You can discover this contained in the cloned package deal at database/sequelpro.spf. Import it into Sequel Pro and you’ll get a connection.

The VVV database documentation additionally supplies a number of different connection strategies to fit your wants.

I additionally usually must examine on the emails which are being despatched in my WordPress installs. For this VVV supplies the MailHog package. MailHog will seize all of your emails and supplies a pleasant net UI to view them. You can entry Mailhog by way of the VVV dashboard which is discovered at vvv.take a look at. You’ll additionally discover entry to phpMyAdmin and many different instruments on the dashboard, so pay attention to it.

If you’re in search of a developer-focused atmosphere to do your work, then VVV is a good selection. It installs every part you want with out touching any of the internals of your pc. Coming from MAMP, which does contact stuff in your pc, VVV was a breath of contemporary air as a result of I knew that if one thing went drastically improper, it might be contained in my Vagrant container and not mess with anything on my machine.

The greatest downside with it’s that if one thing goes improper, it is advisable to have understanding of how server provisioning works to work by and repair issues. The builders are very useful, but it surely nonetheless takes some understanding to work by issues.

Depending in your initiatives the tailor-made to WordPress nature of VVV can be a difficulty. If you’re employed with each Laravel and WordPress chances are you’ll find yourself combating with the WordPress specifics. You certainly can run both Laravel and WordPress projects with VVV however you’re a bit extra out by yourself for those who go that route.

If you haven’t tried VVV earlier than, take it for a spin.

Check Also

How Ethical Brands Can Leverage DoneGood for Better Visibility

How Ethical Brands Can Leverage DoneGood for Better Visibility

For a very long time, consumerism has earned a status as being the bane of …