Prepare your development environment on Linux

To deploy and run Azure Service Fabric applications on your Linux development machine, install the runtime and common SDK. You can also install optional SDKs for Java and .NET Core development.


The following operating system versions are supported for development:

  • Ubuntu 16.04 (Xenial Xerus)

Installation Methods

1. Script installation

A script is provided for convenience for installing the Service Fabric runtime and the Service Fabric common SDK along with sfctl CLI. Run the manual installation steps in the next section to determine what is being installed and the licenses that are being agreed to. Running the script assumes you agree to the licenses for all the software that is being installed.

After the script is executed successfully, you can directly skip to Set up a local cluster.

sudo curl -s | sudo bash

2. Manual Installation

For manual installation of Service Fabric runtime and common SDK, follow the rest of this guide.

Update your APT sources

To install the SDK and the associated runtime package via the apt-get command-line tool, you must first update your Advanced Packaging Tool (APT) sources.

  1. Open a terminal.
  2. Add the Service Fabric repo to your sources list.

    sudo sh -c 'echo "deb [arch=amd64] xenial main" > /etc/apt/sources.list.d/servicefabric.list'
  3. Add the dotnet repo to your sources list.

    sudo sh -c 'echo "deb [arch=amd64] xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
  4. Add the new Gnu Privacy Guard (GnuPG, or GPG) key to your APT keyring.

    sudo apt-key adv --keyserver --recv-keys 417A0893
    sudo apt-key adv --keyserver hkp:// --recv-keys 417A0893
  5. Add the official Docker GPG key to your APT keyring.

    sudo apt-get install curl
    sudo curl -fsSL | sudo apt-key add -
  6. Set up the Docker repository.

    sudo add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"
  7. Refresh your package lists based on the newly added repositories.

    sudo apt-get update

Install and set up the Service Fabric SDK for local cluster setup

After you have updated your sources, you can install the SDK. Install the Service Fabric SDK package, confirm the installation, and agree to the license agreement.

sudo apt-get install servicefabricsdkcommon


The following commands automate accepting the license for Service Fabric packages:

echo "servicefabric servicefabric/accepted-eula-ga select true" | sudo debconf-set-selections
echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-ga select true" | sudo debconf-set-selections

Set up a local cluster

Once the installation completes, you should be able to start a local cluster.

  1. Run the cluster setup script.

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/
  2. Open a web browser and go to Service Fabric Explorer. If the cluster has started, you should see the Service Fabric Explorer dashboard.

    Service Fabric Explorer on Linux

    At this point, you can deploy pre-built Service Fabric application packages or new ones based on guest containers or guest executables. To build new services by using the Java or .NET Core SDKs, follow the optional setup steps that are provided in subsequent sections.


Standalone clusters aren't supported in Linux.


If you have an SSD disk avaiable, it is recommended to pass an SSD folder path using `--clusterdataroot` with for superior performance.

Set up the Service Fabric CLI

The Service Fabric CLI has commands for interacting with Service Fabric entities, including clusters and applications. Follow the instructions at Service Fabric CLI to install the CLI.

Set up Yeoman generators for containers and guest executables

Service Fabric provides scaffolding tools that help you create Service Fabric applications from a terminal using Yeoman template generators. Follow these steps to set up the Service Fabric Yeoman template generators:

  1. Install nodejs and NPM on your machine


sudo apt-get install npm
sudo apt install nodejs-legacy
  1. Install Yeoman template generator on your machine from NPM

    sudo npm install -g yo
  2. Install the Service Fabric Yeo container generator and guest executable generator from NPM

    sudo npm install -g generator-azuresfcontainer  # for Service Fabric container application
    sudo npm install -g generator-azuresfguest      # for Service Fabric guest executable application

After you have installed the generators, you should be able to create guest executable or container services by running yo azuresfguest or yo azuresfcontainer, respectively.

Set up .NET Core 2.0 development

Install the .NET Core 2.0 SDK for Ubuntu to start creating C# Service Fabric applications. Packages for .NET Core 2.0 Service Fabric applications are hosted on, currently in preview.

Set up Java development

To build Service Fabric services using Java, install JDK 1.8 and Gradle to run build tasks. The following snippet installs Open JDK 1.8 along with Gradle. The Service Fabric Java libraries are pulled from Maven.

 sudo apt-get install openjdk-8-jdk-headless
 sudo apt-get install gradle

Install the Eclipse Neon plug-in (optional)

You can install the Eclipse plug-in for Service Fabric from within the Eclipse IDE for Java Developers. You can use Eclipse to create Service Fabric guest executable applications and container applications in addition to Service Fabric Java applications.

  1. In Eclipse, ensure that you have latest Eclipse Neon and the latest Buildship version (1.0.17 or later) installed. You can check the versions of installed components by selecting Help > Installation Details. You can update Buildship by using the instructions at Eclipse Buildship: Eclipse Plug-ins for Gradle.

  2. To install the Service Fabric plug-in, select Help > Install New Software.

  3. In the Work with box, type

  4. Click Add.

    The Available Software page

  5. Select the ServiceFabric plug-in, and then click Next.

  6. Complete the installation steps, and then accept the end-user license agreement.

If you already have the Service Fabric Eclipse plug-in installed, make sure that you have the latest version. You can check by selecting Help > Installation Details and then searching for Service Fabric in the list of installed plug-ins. If a newer version is available, select Update.

For more information, see Service Fabric plug-in for Eclipse Java application development.

Update the SDK and runtime

To update to the latest version of the SDK and runtime, run the following commands:

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon

To update the Java SDK binaries from Maven, you need to update the version details of the corresponding binary in the build.gradle file to point to the latest version. To know exactly where you need to update the version, you can refer to any build.gradle file in Service Fabric getting-started samples here.


Updating the packages might cause your local development cluster to stop running. Restart your local cluster after an upgrade by following the instructions on this page.

Remove the SDK

To remove the Service Fabric SDKs, run the following:

sudo apt-get remove servicefabric servicefabicsdkcommon
sudo npm uninstall generator-azuresfcontainer
sudo npm uninstall generator-azuresfguest
sudo apt-get install -f

Next steps