Skip to main content
Version: 0.15

PDK Provider Setup

In Common Fate v0.15+, Providers built with the Provider Development Kit (PDK) are deployed separately to a Common Fate deployment.

Installing cf

To deploy a PDK Provider, start by installing cf.


cf version above 0.11.0 has all the PDK related commands inside the cf oss subcommand.

cf is a command-line interface (CLI) tool for performing authenticated actions against a Common Fate deployment. It provides commands for creating and updating Target Groups, Handlers, Routes and also for operational tasks like viewing Handler logs.

To install cf, follow the instructions below based on your computer's operating system:

Homebrew is an open source package manager for MacOS. We publish a Homebrew formula for cf. To install cf with Homebrew, run the commands below in your terminal.

brew install common-fate/tap/cf

Verify the installation

You can verify the integrity and authenticity of the cf binary you have downloaded by running through the verification process here. You will need to replace references to granted in URLs with cf.

Check that cf has been installed correctly by running the following command:

cf -v

You should see a version output similar to the below:

cf version 0.11.0