Skip to content
CLI tool for spawning and running containers on Windows according to the OCI specification
Branch: develop
Clone or download
arjun024 and sophiewigmore Readme: MD files require extra new lines
Signed-off-by: Sophie Wigmore <>
Latest commit c8c00df Mar 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
hcs Hcs-client: Retry HNS's network-Create() on known error Mar 13, 2019
network Consider ip version when getting / setting mtu Oct 22, 2018
runtime Runtime: Fix OpenProcess race Feb 5, 2019
vendor hccshim: bumped hcsshim to v0.8.5 Feb 5, 2019
Gopkg.lock Gopkg.lock: Update hcsshim rev after cleaning up fork Feb 5, 2019
NOTICE add license and notice May 23, 2017


winc is a CLI tool for spawning and running containers on Windows according to the OCI specification.



  • Golang
    • Make sure you have set a GOPATH
  • Git
  • mingw-w64
    • Select x86_64 as the target architecture
    • After install, ensure that gcc.exe is in your PATH

To clone and build winc.exe:

go get -d
cd $GOPATH/src/
go build ./cmd/winc


Set the following environment variables first:

WINDOWS_VERSION to your version of Windows (e.g. "2019").

WINC_TEST_ROOTFS to the path to a container image (e.g. to test with the microsoft/windowsservercore Docker image - "docker:///microsoft/windowsservercore").

GROOT_BINARY to the path of the groot executable to use while running integration test.

GROOT_IMAGE_STORE to the path of the directory that groot uses for layers and the volume (e.g. "C:\ProgramData\groot").

To install Ginkgo and run the tests:

go get
cd $GOPATH/src/
ginkgo -r -race -keepGoing


Check out winc bosh release readme for creating new containers using winc.

You can’t perform that action at this time.