diff --git a/README.md b/README.md
index fcc83a1..e870827 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,42 @@
-vagrant-docker-example
-======================
+# vagrant-docker-example
 
-Example of basic vagrant docker provider usage
+Example of basic Vagrant Docker provider usage
 
-Installation
-------------
+> Running Docker as a provider in non-Linux environment will require the installation on a Docker Host VM, where Docker containers will run.
 
-Install vagrant: using http://vagrantup.com/downloads.html
+> Because of an error with current version of `hashicorp/boot2docker` (rsync has been removed), it has been replaced by `dduportal/boot2docker`.
 
-If you are using linux, install docker: http://docs.docker.com/linux/step_one/
-On mac and windows, install docker toolbox: https://www.docker.com/toolbox
+## Installation
 
-Clone this repo
+### VirtualBox
+
+Install VirtualBox from: https://www.virtualbox.org/wiki/Downloads
+
+### Vagrant
+
+Install Vagrant using: http://vagrantup.com/downloads.html
+
+### Docker
+
+If you are using Linux, install Docker: http://docs.docker.com/linux/step_one/
+
+On Mac and Windows, install Docker Toolbox from: https://www.docker.com/toolbox
+
+If you prefer, you can install Docker on Mac using `homebrew`:
+
+    brew install docker
+	brew install docker-machine
+	brew install docker-compose
+
+### Run Vagrantfile
+
+Clone this repo.
 
 From repo folder:
 
     vagrant up
 
-    # on mac and windows, you will be asked for a password, enter: tcuser
+    # on Mac and Windows, you will be asked for a password, enter: tcuser
     # you will be asked for password twice for 2 folders to sync
 
     vagrant ssh  # user tcuser password again
diff --git a/Vagrantfile b/Vagrantfile
index 1e59742..59650d9 100644
--- a/Vagrantfile
+++ b/Vagrantfile
@@ -49,6 +49,7 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
   # Example for VirtualBox:
   #
   config.vm.provider "docker" do |d|
+    d.vagrant_vagrantfile = "Vagrantfile-boot2docker"
     d.build_dir = "."
     d.has_ssh = true
   end
diff --git a/Vagrantfile-boot2docker b/Vagrantfile-boot2docker
new file mode 100644
index 0000000..47af0fb
--- /dev/null
+++ b/Vagrantfile-boot2docker
@@ -0,0 +1,3 @@
+Vagrant.configure("2") do |config|
+  config.vm.box = "dduportal/boot2docker"
+end
\ No newline at end of file