Wocker 1.2 changes the hostname from wocker.dev to wocker.test. Please also update your Vagrantfile or reinstall Wocker.

How to use Nginx

wocker ~ $ wocker run [--name=""] wocker/wocker:nginx

This creates and runs a new container over wocker/wocker:nignx image. This could take a while on the first run as your local machine downloads the required image.

How to use MailHog

1. Create or start a container

wocker ~ $ wocker run


wocker ~ $ wocker start CONTAINER

2. Visit the following site in your browser


For more information about MailHog, please see https://github.com/mailhog/MailHog.

How to move an old container from wocker.dev to wocker.test

1. Check the hostname on your Vagrantfile

config.vm.hostname = "wocker.test"

Make sure you have the above code on line 27 on your Vagrantfile.

2. Start and connect to the guest machine

$ vagrant up
$ vagrant ssh

3. Start your v1.1.x Wocker container

wocker ~ $ wocker start CONTAINER

CONTAINER can be a name or ID of a container.

4. Replace wocker.dev with wocker.test

wocker ~ $ wocker wp search-replace wocker.dev wocker.test

5. Visit the following site in your browser


Downgrade WordPress version

For example, downgrade WordPress to 3.5.

1. Run a new container

wocker ~ $ wocker run --name test

This will create a new container test. If you already have a container to downgrade, just start it, or if it’s running, just skip this step.

2. Download version 3.5

wocker ~ $ wocker wp core download --version=3.5 --force

This will force download WordPress 3.5 to the running container using the wocker wp command. After this finishes successfully, you will have a WordPress 3.5 environment if you visit http://wocker.dev. You can change 3.5 to any version you want.