Prepare your development environment on Windows

To build and run Azure Service Fabric applications on your Windows development machine, install the Service Fabric runtime, SDK, and tools. You also need to enable execution of the Windows PowerShell scripts included in the SDK.


Ensure you are using a supported Windows version.

Install the SDK and tools

Web Platform Installer (WebPI) is the recommended way to install the SDK and tools. If you receive runtime errors using WebPI, you can also find direct links to the installers in the release notes for a specific Service Fabric release. The release notes can be found in the various release announcements on the Service Fabric team blog.

WebPI may already be installed on your computer. Search for it by using the Windows key. If it's not present, you can download it here. NB The page mentions that the tool will be retired fairly soon (July 1, 2022), so you may need to look for alternative ways to install this after that date. Stay tuned!


Local Service Fabric development cluster upgrades are not supported.

To use Visual Studio 2017 or 2019

The Service Fabric Tools are part of the Azure Development workload in Visual Studio 2019 and 2017. Enable this workload as part of your Visual Studio installation. In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime using Web Platform Installer.

SDK installation only

If you only need the SDK, you can install this package:

The current versions are:

  • Service Fabric SDK and Tools 6.0.1028
  • Service Fabric runtime 9.0.1028

For a list of supported versions, see Service Fabric versions


Single machine clusters (OneBox) are not supported for Application or Cluster upgrades; delete the OneBox cluster and recreate it if you need to perform a Cluster upgrade, or have any issues performing an Application upgrade.

Enable PowerShell script execution

Service Fabric uses Windows PowerShell scripts for creating a local development cluster and for deploying applications from Visual Studio. By default, Windows blocks these scripts from running. To enable them, you must modify your PowerShell execution policy. Open PowerShell as an administrator and enter the following command:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Install Docker (optional)

Service Fabric is a container orchestrator for deploying microservices across a cluster of machines. To run Windows container applications on your local development cluster, you must first install Docker for Windows. Get Docker CE for Windows (stable). After installing and starting Docker, right-click on the tray icon and select Switch to Windows containers. This step is required to run Docker images based on Windows.

Next steps

Now that you've finished setting up your development environment, start building and running apps.