Various Vagrant envs with Windows 2016/10 and Docker, Swarm mode, LCOW, ...
PowerShell Ruby Shell
Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information.
hyperv Update 17.06.0-ce-rc3 Jun 13, 2017
images Update screenshot Sep 26, 2016
lcow Add experimatal Jan 21, 2018
nano Update 17.03.1-ce Apr 5, 2017
scripts Update choco package name Jul 19, 2018
swarm-demo Write or update daemon.json Sep 6, 2017
swarm-mode Update linux box Jan 15, 2018
windows10 Update versions Jan 21, 2018
.gitignore Update docker 1.8.1. Try Hyper-V. Aug 14, 2015
LICENSE Add LICENSE Dec 16, 2015 Add LCOW scenario Jan 21, 2018
Vagrantfile Update box Aug 11, 2017


This repo is a collection of various Vagrant environments to work with Windows Containers on a Windows Server 2016 or Windows 10 VM.

There are different Vagrantfiles for each scenario:


This repo has started with a single Vagrantfile that is explained below. As you can see there are several interesting setups here as well in the sub folders.

Have a look at my blog posts how to Setup a local Windows 2016 TP5 Docker VM and Adding Hyper-V support to 2016 TP5 Docker VM for more details. I also can recommend a more up to date guide Getting started with Windows Containers by @glennsarti

After provisioning the box has the following tools installed:

  • Windows Server 2016 with Docker Engine 17.10.0-ce and client
  • docker-machine 0.13.0
  • docker-compose 1.18.0
  • (Docker Tab completion for PowerShell (posh-docker))
  • Chocolatey
  • Git command line
  • Git Tab completion for PowerShell (posh-git)
  • SSH client

Optionally you can create a Hyper-V Docker Linux machine and have a multi architecture experience in one VM.

Tested with Vagrant 1.9.3, VMware Fusion Pro 8.5.6 on a MacBookPro with Retina display. The Vagrant box will be started in fullscreen mode also with Retina support.

You can learn and play a lot of scenarios with it:

Future work will be a Docker Swarm with both Linux and Windows Docker Engines...

Get the base box

First register to evaluate Windows 2016, but you don't need to download the ISO manually.

For the next step you need Packer. You have several ways how to install it. The easiest way is to install it via Homebrew. After you have installed Homebrew. Run the following command when you installed Homebrew:

brew install packer

If you don't have the Vagrant windows_2016_docker base box you need to create it first with Packer. See my packer-windows repo to build the base box.

To build the base box you have to run these commands on your host machine:

git clone
cd packer-windows
packer build --only=vmware-iso windows_2016_docker.json
vagrant box add windows_2016_docker

Spin up the box

To start the VM with Vagrant run this command

vagrant up

You only have to logout and login once to have the Docker tools in user vagrant's PATH.

Create some Windows Docker Container images

You may clone my dockerfiles-windows repo and create some container images.

git clone
cd dockerfiles-windows
cd node

Test the nightly Windows Docker Engine

You can update the Docker Engine with the script


This will stop the Docker service, download the nightly build from and restart the service.

Create a Linux Docker machine in Hyper-V

If you want to try out multi architecture you also use docker-machine to create a Linux Docker Engine running in Hyper-V. I have prepared a script that will set up everything as there are some known issues.


This PowerShell script creates a Docker machine and updates Docker Engine to the latest so that the Windows Docker client is able to communicate with the Linux Docker Engine.

Use the Linux Docker machine

Open a PowerShell terminal as an administrator and select the Linux Docker machine with

docker-machine env --shell powershell | iex

Now run your first busybox container with

docker run -it busybox uname -a

Windows Docker Swarm demo

See subdirectory swarm-demo

Use Vagrant to control your box

From your host control your Vagrant box with the usual Vagrant workflow:

  • vagrant up
  • vagrant halt
  • vagrant destroy -f
  • vagrant snap take
  • vagrant snap rollback
  • ...

Writing the installation script for the Hyper-V Docker machine the snapshot functions helped me a lot to test the script again and again.