Set up a Linux Service Fabric cluster on your Windows developer machine

This document covers how to set up a local Linux Service Fabric on Windows development machines. Setting up a local Linux cluster is useful to quickly test applications targeted for Linux clusters but are developed on a Windows machine.


Linux-based Service Fabric clusters do not run natively on Windows. To run a local Service Fabric cluster, a pre-configured Docker container image is provided. Before you get started, you need:

  • At least 4-GB RAM
  • Latest version of Docker
  • Docker must be running on Linux mode


  • You can follow the steps mentioned in the official Docker documentation to install Docker on your Windows.
  • Once you are done installing, validate if it got installed properly following the steps mentioned here

Create a local container and setup Service Fabric

To set up a local Docker container and have a service fabric cluster running on it, perform the following steps in PowerShell:

  1. Update the Docker daemon configuration on your host with the following and restart the Docker daemon:

      "ipv6": true,
      "fixed-cidr-v6": "2001:db8:1::/64"

    The advised way to update is - go to Docker Icon > Settings > Daemon > Advanced and update it there. Next, restart the Docker daemon for the changes to take effect.

  2. In a new directory create a file called Dockerfile to build your Service Fabric Image:

    FROM microsoft/service-fabric-onebox
    WORKDIR /home/ClusterDeployer
    RUN ./
    #Generate the local
    RUN locale-gen en_US.UTF-8
    #Set environment variables
    ENV LANG=en_US.UTF-8
    ENV LC_ALL=en_US.UTF-8
    EXPOSE 19080 19000 80 443
    #Start SSH before running the cluster
    CMD /etc/init.d/ssh start && ./


    You can adapt this file to add additional programs or dependencies into your container. For example, adding RUN apt-get install nodejs -y will allow support for nodejs applications as guest executables.


    By default, this will pull the image with the latest version of Service Fabric. For particular revisions, please visit the Docker Hub page

  3. To build your reusable image from the Dockerfile open a terminal and cd to the directly holding your Dockerfile then run:

    docker build -t mysfcluster .


    This operation will take some time but is only needed once.

  4. Now you can quickly start a local copy of Service Fabric, whenever you need it, by running:

    docker run --name sftestcluster -d -v //var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mysfcluster


    Provide a name for your container instance so it can be handled in a more readable manner.

    If your application is listening on certain ports, the ports must be specified by using additional -p tags. For example, if your application is listening on port 8080, add the following -p tag:

    docker run -itd -p 19080:19080 -p 8080:8080 --name sfonebox microsoft/service-fabric-onebox

  5. The cluster will take a short amount of time to start, you can view logs using the following command or jump to the dashboard to view the clusters health http://localhost:19080:

    docker logs sftestcluster
  6. After step 5 is completed successfully, you can go to http://localhost:19080 from your Windows and you would be able to see the Service Fabric explorer. At this point, you can connect to this cluster using any tools from your Windows developer machine and deploy application targeted for Linux Service Fabric clusters.


    The Eclipse plugin is currently not supported on Windows.

  7. When you are done, stop and cleanup the container with this command:

    docker rm -f sftestcluster

Known Limitations

The following are known limitations of the local cluster running in a container for Mac's:

  • DNS service does not run and is not supported Issue #132

Next steps