Skip to content
Initialise a WordPress vagrant box based on homestead box
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.

WordPress Vagrant


Initialize a WordPress Vagrant box based on homestead.

Laravel Homestead is an official, pre-packaged Vagrant "box" that provides you a wonderful development environment for Laravel framework.

As homestead already contains everything that we need, here we are extending homestead for our WordPress project.

WordPress Vagrant Includes

  • Ubuntu 18.04
  • Git
  • PHP 7.2
  • PHP 7.1
  • PHP 7.0
  • PHP 5.6
  • Nginx
  • Apache (Optional)
  • MySQL
  • MariaDB (Optional)
  • Sqlite3
  • PostgreSQL
  • Composer
  • Node (With Yarn, Bower, Grunt, and Gulp)
  • Redis
  • Memcached
  • Beanstalkd
  • Mailhog
  • Elasticsearch (Optional)
  • ngrok
  • wp-cli
  • Zend Z-Ray
  • Go
  • Minio
  • PHPUnit
  • Running WordPress Instance


Get started

Initial setup

Clone WordPress Vagrant:

git clone

Then go to your cloned directory and install composer dependencies by running following command:

composer install

Setting Your SSH Key

You will need to have ssh keys for accessing virtual server. On Mac and Linux, you can create an SSH key pair using the following command:

ssh-keygen -t rsa -C "you@wordpress"

Run vagrant box

To run vagrant box type:

vagrant up

This shall create a new instance of Ubuntu 14.04 with included softwares.

To ssh new instance, run following command:

vagrant ssh

Access your WordPress blog

You can see your WordPress blog by visiting

To use custom domain, add following line to your hosts file:

On Mac and Linux, this file is located at /etc/hosts. On Windows, it is located at C:\Windows\System32\drivers\etc\hosts.

Now visit to check your new blog.

You can find all WordPress files inside wordpress directory on your local machine. Now use your favorite editor to modify files. Any modification will immediately reflect on virtual machine.

Admin access of WordPress:

  • username: admin
  • password: secret

MySQL Database:

  • dbname: wordpress
  • dbuser: homestead
  • dbpass: secret


Homestead.yaml comes with several configurations. You can map any local directory to virtual server and also configure custom domain.

To get more info about homestead, visit Laravel Homestead

You can’t perform that action at this time.