Fix Port number for Service Fabric ASP.NET Core on the local development machine

less than 1 minute read

To do so, you need to fix the port number for your local machine. On other environments like Staging or Production, you can let the Service Fabric service decide it.


Update the manifest file to have ResourceOverrides with Endpoint settings. Add a parameter for port number.

  <Parameter Name="Api_Port" DefaultValue="" />
  <ServiceManifestRef ServiceManifestName="Service.ApiPkg" 
   ServiceManifestVersion="1.0.0" />
  <ConfigOverrides />
      <Endpoint Name="ServiceEndpoint" Port="[Api_Port]" 
       Protocol="http" Type="Input" />

The defaultt value is empty, which means the Service Fabric service will decide it.

In ApplicationParameters directory, you have 3 files

  • Cloud.xml
  • Local.1Node.xml
  • Local.5Node.xml

Cloud.xml contains parameter values for remote environments like Production. Local.xNode.xml files have the same parameters for local environment as the name suggest.

# Cloud.xml
<Parameter Name="Api_Port" Value="" />

# Local.1Node.xml, Local.5Node.xml
<Parameter Name="Api_Port" Value="8221" />

Then the port number will be 8221 on the local cluster only.