Fork me on GitHub

Installation

Linux (Ubuntu/Debian)

To use Virtualbox make sure you have vt-x enabled in your BIOS.

sudo apt-get install -y vagrant virtualbox virtualbox-dkms
git clone https://github.com/Seravo/wordpress ~/wordpress-dev
cd ~/wordpress-dev
vagrant plugin install vagrant-hostsupdater vagrant-triggers vagrant-bindfs
vagrant up

Optional: If you want to have PHP Composer locally installed run:

$ sudo apt-add-repository -y ppa:duggan/composer
$ sudo apt-get update
$ sudo apt-get install php5-composer

Ubuntu 16.04 and later need ruby-dev

If you see this error message on Ubuntu 16.04 or later:

$ vagrant up
mkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h

It means you need to install separately the Ruby development files:

sudo apt-get install ruby-dev

Ubuntu 17.04 and later

VirtualBox sets up the vboxnet0 virtual interface routing using the legacy ifconfig and route commands, instead of the modern ip command. For networking to work properly, you need to run apt install net-tools.

Linux (Fedora)

Add RPMFusion repositories. See RpmFusion. Repository is needed for Virtualbox.

Clone the WordPress Git repo and run following commands:

sudo yum install vagrant virtualbox
sudo yum install ruby-devel # Needed to build native ruby extensions
sudo gem update bundler
sudo gem install hittimes -v '1.2.2'
vagrant plugin install vagrant-hostsupdater vagrant-triggers vagrant-bindfs

# Needed to load the kernel module for virtualbox, you may want to load it automatically on boot...
sudo modprobe vboxdrv
vagrant up

Linux (General)

If you get errors related to creating host-only network adapters during vagrant up, run sudo vboxreload. It seems that sometimes virtualbox kernel modules are not working correctly after the machine wakes up from sleep.

MacOS X

  1. Install Xcode: xcode-select --install
  2. Install Vagrant
  3. Install Virtualbox
  4. Clone this repo: git clone https://github.com/Seravo/wordpress ~/wordpress-dev
  5. Run the installation in terminal:
    cd ~/wordpress-dev
    vagrant plugin install vagrant-hostsupdater vagrant-triggers vagrant-bindfs
    vagrant up
    

    Optional: Vagrant Manager for OS X can help you manage multiple Vagrant boxes.

Windows (Cygwin)

To use Virtualbox make sure you have vt-x enabled in your BIOS. You might need to disable hyper-v in order to use Virtualbox.

  1. Install Cygwin and via Cygwin openssh and git
  2. Install Vagrant
  3. Install Virtualbox
  4. Clone this repo: git clone https://github.com/Seravo/wordpress ~/wordpress-dev
  5. Run the installation in terminal:
    cd ~/wordpress-dev
    vagrant plugin install vagrant-hostsupdater vagrant-triggers vagrant-bindfs
    vagrant up
    

    In theory, Seravo WordPress should work even without Cygwin installed, but we strongly recommend using Cygwin for doing WordPress development on Windows machines.

Optional: Vagrant Manager for Windows can help you manage multiple Vagrant boxes.