sfctl

What it is and what it does

sfctl is a command-line tool for interacting with Azure Service Fabric clusters. It provides commands to manage applications, services, nodes, partitions, replicas, and cluster configuration, as well as to query health states and retrieve events. The tool wraps the Azure Service Fabric SDK and presents cluster operations through a shell interface.

Typical usage involves connecting to a cluster endpoint, then issuing commands to deploy applications, manage services, inspect cluster health, and perform administrative tasks. It depends on knack for CLI framework, requests and msrest for HTTP communication, and Azure SDK libraries (msrestazure, azure-servicefabric, adal) for authentication and Service Fabric API access. The package is actively maintained and tracks Service Fabric runtime versions; version 11.2.1 uses the 8.2 SDK.

Use it for:

• Deploy and manage Service Fabric applications from the command line in CI/CD pipelines.
• Query cluster health, node status, and application state for monitoring and troubleshooting.
• Perform cluster upgrades, node management, and configuration overrides on Service Fabric clusters.
• Retrieve events and diagnostics from the EventStore service for cluster analysis.
• Manage Docker Compose deployments and mesh resources on Service Fabric.
• Automate application uploads with parallelized file transfer and compression options.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A command-line interface for managing Azure Service Fabric clusters, applications, services, and related entities through the sfctl command.

Yes. sfctl is a production-stable, actively maintained CLI for Azure Service Fabric with low install friction, no known vulnerabilities, and permissive licensing. Install it if you manage Service Fabric clusters or need to automate fabric operations; it is the standard tool for this purpose and integrates well with Azure tooling and CI/CD workflows.

Install

sfctl on PyPI

pip install sfctl

uv add sfctl

poetry add sfctl

Installing sfctl

Before you install

Low install friction with a pure Python wheel distribution. Actively maintained as of June 2026 with recent dependency updates in version 11.2.1. Supports Python 3.8–3.10 and has 13 runtime dependencies including knack, requests, and Azure SDK libraries.

License in practice

MIT license (permissive) places no restrictions on use, modification, or distribution in commercial or private projects.

Quickstart

pip install sfctl
sfctl -h

Requires Python >3.8 and <4. Connection to an Azure Service Fabric cluster endpoint is needed for most commands; default is http://localhost:19080.

Verify before relying

• Whether all 13 runtime dependencies are required for basic cluster operations or if some are optional for specific features.
• Current compatibility with the latest Azure Service Fabric runtime versions beyond 8.2.
• Whether telemetry collection (added in version 7.0.0) can be disabled or opted out of.

Package facts

Evidence: sfctl-11.2.1-py3-none-any.whl

Keywords: servicefabric, azure

Tags

More Build Tools packages