Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Hello ServiceFabric

This project contains a Hello World example of running a ServiceStack Self Hosted Service inside Microsoft's Service Fabric platform.

Service Fabric is a distributed systems platform that enables wrapping your self-hosted Services inside a managed package, allowing them to be managed like Containers where they can be scaled on a cluster managed independently using Service Fabric's orchestration tooling.

Create clusters for Service Fabric anywhere

You can create clusters for Service Fabric in many environments, including Azure or on premises, on Windows Server, or on Linux. In addition, the development environment in the SDK is identical to the production environment, and no emulators are involved.

For more information on creating clusters on-premises, read creating a cluster on Windows Server or Linux or for Azure creating a cluster via the Azure portal.


Service Fabric requires running VS.NET in Admin Mode in order to launch/debug your Web App in a local Service Fabric cluster.

The endpoint for your Self-Hosted Service is configured in PackageRoot\ServiceManifest.xml which defaults to:

    <!-- This endpoint is used by the communication listener to obtain the port on which to 
        listen. Please note that if your service is partitioned, this port is shared with 
        replicas of different partitions that are placed in your code. -->
    <!--<Endpoint Name="ServiceEndpoint" />-->
    <Endpoint Name="ServiceEndpoint" Type="Input" Protocol="http" Port="8281" />

After running your Web App in VS.NET, you can check that your ServiceStack Service is working by navigating to http://localhost:8281/metadata.

Changes from Service Fabric Application VS.NET template

The main difference of this project from the default Service Fabric default VS.NET Service Fabric Application Template is the SelfHostCommunicationListener.cs adapter class which implements Service Fabric's ICommunicationListener interface for managing the life-cycle of a ServiceStack Self-Host Service.

When creating a new Service Fabric Self Hosted Service from VS.NET template you can just copy into your project:

Then change your StatelessSelfHost to use the class configured with your ServiceStack AppHost, e.g:

protected override IEnumerable<ServiceInstanceListener> CreateServiceInstanceListeners()
    var endpoints = Context.CodePackageActivationContext.GetEndpoints()
        .Where(endpoint => endpoint.Protocol==EndpointProtocol.Http || endpoint.Protocol==EndpointProtocol.Https)
        .Select(endpoint => endpoint.Name);

    return endpoints.Select(endpoint => new ServiceInstanceListener(
        serviceContext => new SelfHostCommunicationListener(
            new AppHost(), serviceContext, ServiceEventSource.Current, endpoint), endpoint));


ServiceStack SelfHost Example hosted in a ServiceFabric Stateless Service






No releases published


No packages published