Public Repository

Last pushed: 6 days ago
Short Description
Base docker image for hosting WCF services in Windows Server Core based container
Full Description

Supported Windows Server, version 1803 amd64 tags

Supported Windows Server, version 1709 amd64 tags

Supported Windows Server 2016 amd64 tags

This image is uploaded to the microsoft/wcf docker hub repo with the information of the supported specific tags.

What is WCF?

The Windows Communication Foundation (WCF) is a framework for building service-oriented applications. Using WCF, you can send data as asynchronous messages from one service endpoint to another. A service endpoint can be part of a continuously available service hosted by IIS, or it can be a service hosted in an application.

How to use this image?

Create a Dockerfile with your WCF service IIS Hosted or selfhosted

FROM microsoft/wcf

WORKDIR WcfService

RUN powershell -NoProfile -Command \
    Import-module IISAdministration; \
    New-IISSite -Name "WcfService" -PhysicalPath C:\WcfService -BindingInformation "*:83:"


COPY content/ .

You can then build and run the Docker image:

$ docker build -t wcfserviceimage .
$ docker run -d -p 83:83 --name my-wcfservice wcfserviceimage

There is no need to specify an ENTRYPOINT in your Dockerfile since an entrypoint application is already specified that monitors the status of the IIS World Wide Web Publishing Service (W3SVC).

Verify in the browser

With the current release, you can't use http://localhost to browse your site from the container host. This is because of a known behavior in WinNAT, and will be resolved in future. Until that is addressed, you need to use the IP address of the container.

Once the container starts, you'll need to finds its IP address so that you can connect to your running container from a browser. You use the docker inspect command to do that:

docker inspect -f "{{ .NetworkSettings.Networks.nat.IPAddress }}" my-wcfservice

You will see an output similar to this:

You can connect the running container using the IP address and configured port,<wcfservice.svc> in the example shown.

For a comprehensive tutorial on running an WCF service in a container, check out WCF service samples in container

Supported Docker Versions

This image has been tested on Docker Versions 1.12.2-cs2-ws-beta or higher.




Microsoft Corporation (or based on where you live, one of its affiliates) (referenced as "us," "we," or "Microsoft") licenses this Container OS Image supplement to you ("Supplement"). You are licensed to use this Supplement in conjunction with the underlying host operating system software ("Host Software") solely to assist running the containers feature in the Host Software. The Host Software license terms apply to your use of the Supplement. You may not use it if you do not have a license for the Host Software. You may use this Supplement with each validly licensed copy of the Host Software.

User Feedback

If you have any issues or concerns, reach out to us through a GitHub issue.

Docker Pull Command