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.


The following operating system versions are supported for development:

  • Ubuntu 16.04 (Xenial Xerus)

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] trusty 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 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 SDK for containers and guest executables

After you have updated your sources, you can install the SDK.

  1. 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-v1 select true" | debconf-set-selections
    echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-v1 select true" | debconf-set-selections
  2. Run the SDK setup script.

    sudo /opt/microsoft/sdk/servicefabric/common/

After you have installed the common SDK package, you should be able to create apps with guest executable or container services by running yo azuresfguest or yo azuresfcontainer. You might need to set your $NODE_PATH environment variable to the location of the node modules.

    export NODE_PATH=$NODE_PATH:$HOME/.node/lib/node_modules 

If you are using the environment as root, you might need to set the variable with the following command:

    export NODE_PATH=$NODE_PATH:/root/.node/lib/node_modules 

You might want to add these commands to your ~/.bashrc file so that you don't have to set the environment variable at every login.

Set up the XPlat Service Fabric CLI

The XPlat CLI includes commands for interacting with Service Fabric entities, including clusters and applications. It is based on Node.js, so ensure that you have installed Node before you proceed with the following instructions:

  1. Clone the GitHub repo to your development machine.

    git clone
  2. Switch to the cloned repo and install the CLI dependencies by using the node package manager (npm).

    cd azure-xplat-cli
    npm install
  3. Create a symlink from the bin/azure folder of the cloned repo to /usr/bin/azure.

    sudo ln -s $(pwd)/bin/azure /usr/bin/azure
  4. Finally, enable auto-completion Service Fabric commands.

    azure --completion >> ~/
    echo 'source ~/' >> ~/.bash_profile
    source ~/

Set up Azure CLI 2.0

As an alternative to the XPlat CLI, there is now a Service Fabric command module included in Azure CLI.

For more information about installing Azure CLI 2.0 and using the Service Fabric commands, see Get started with Service Fabric and Azure CLI 2.0.

Set up a local cluster

If the installation is successful, 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. The preview supports only one-box and Azure Linux multi-machine clusters.

Install the Java SDK (optional, if you want to use the Java programming models)

The Java SDK provides the libraries and templates that are required to build Service Fabric services by using Java.

  1. Install the Java SDK package.

    sudo apt-get install servicefabricsdkjava
  2. Run the SDK setup script.

    sudo /opt/microsoft/sdk/servicefabric/java/

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.


The Java SDK is a prerequisite to using the Eclipse plug-in, even if you use it only for guest executables and container 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.

Install the .NET Core SDK (optional, if you want to use the .NET Core programming models)

The .NET Core SDK provides the libraries and templates that are required to build Service Fabric services with .NET Core.

  1. Install the .NET Core SDK package.

    sudo apt-get install servicefabricsdkcsharp
  2. Run the SDK setup script.

    sudo /opt/microsoft/sdk/servicefabric/csharp/

Update the SDK and runtime

To update to the latest version of the SDK and runtime, run the following commands (deselect the SDKs that you don't want):

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

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.

Next steps