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.


Supported operating system versions

The following operating system versions are supported for development:

  • Windows 7
  • Windows 8/Windows 8.1
  • Windows Server 2012 R2
  • Windows Server 2016
  • Windows 10


Windows 7 support:

  • Windows 7 only includes Windows PowerShell 2.0 by default. Service Fabric PowerShell cmdlets requires PowerShell 3.0 or higher. You can download Windows PowerShell 5.0 from the Microsoft Download Center.
  • Service Fabric Reverse Proxy is not available on Windows 7.

Install the SDK and tools

To use Visual Studio 2017

The Service Fabric Tools are part of the Azure Development workload in Visual Studio 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.

To use Visual Studio 2015 (requires Visual Studio 2015 Update 2 or later)

For Visual Studio 2015, the Service Fabric tools are installed together with the SDK and runtime using the 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 3.2.162
  • Service Fabric runtime 6.3.162
  • Service Fabric Tools for Visual Studio 2015 2.3.10710.3
  • Visual Studio 2017 15.7 includes Service Fabric Tools for Visual Studio 2.3.10710.1

For a list of supported versions, see Service Fabric support

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

Next steps

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