diff --git a/src/Web/Catalog.WebForms/readme.md b/src/Web/Catalog.WebForms/readme.md index 1f8b6274f..32c0a083c 100644 --- a/src/Web/Catalog.WebForms/readme.md +++ b/src/Web/Catalog.WebForms/readme.md @@ -20,16 +20,22 @@ Then, set the startup project in Visual Studio to the *Catalog.WebForms* project ## Configure Windows Containers -The Catalog.WebForms project uses the full framework, so will only run in Windows based Docker containers. Before running in Docker, make sure you -are running Docker with Windows containers configured. Right-click on the Docker node, and if "switch to Windows Containers" is displayed, click that. If "switch to Linux containers" is displayed, you are already running +You'll need to install and configure +[Docker for Windows](https://docs.docker.com/docker-for-windows/install/) to run +this project in Docker containers. + +The Catalog.WebForms project uses the full .NET framework, so will only run in Windows based Docker containers. Before running in *Docker for Windows*, make sure you +are running Docker with Windows containers configured. Right-click on the *Docker for Windows* node, and if "switch to Windows Containers" is displayed, click that. If "switch to Linux containers" is displayed, you are already running with Windows containers. ## Update Configured IP address -There is a current limitation in Docker for Windows when running with -Windows containers where *localhost* doesn't resolve to the Docker host IP. -Instead, you need to find the physical machine's IP address and use that for -the external address of the services. +There is a current limitation when running with +Windows containers where *localhost* doesn't route from the Docker host to a container. + +There are two workarounds for this. You need to find the IP address of the host machine to access +the external address of the services, or you can use the IP address of the host running the container +and its exposed port. This project uses several containers, so the first method is simpler. To find your machine's IP address, run `ipconfig`. Find the IPv4 address for your machine. In the GitHub example, it is configured for a home @@ -42,6 +48,8 @@ your machine's address. ESHOP_EXTERNAL_DNS_NAME_OR_IP=192.168.1.103 ``` +For more details on the issue and workarounds, see [this StackOverflow post and answer](http://stackoverflow.com/questions/43769806/docker-for-windows-cannot-access-service-on-exposed-port-in-windows-container-m/43770786) + ## Building for Docker The Visual Studio tooling to build and start the docker application isn't