V8 CLI Installation Guide

Downloading the latest v8 CF CLI

Important Note: The v8 CF CLI binary is named cf8 with a symlink cf which points to it so CLI commands can be invoked using either cf or cf8.

Compatibility

The v8 CLI's minimum supported version of the CC API is 3.99.0 (published in CAPI release 1.109.0). See the releases page for the minimum CAPI versions required for each v8 release.

Installing using a package manager

Mac OS X and Linux

using Homebrew via the cloudfoundry tap:

brew install cloudfoundry/tap/cf-cli@8

Note: cf tab completion requires bash-completion to be installed properly in order to work.

Windows

using Chocolatey

choco install cloudfoundry-cli

Debian and Ubuntu based Linux distributions. Supported versions include Ubuntu 22.04 Jammy with apt version 2.4.13 or newer:

(apt update && apt install --yes curl gnupg) > /dev/null 2>&1

# Add the Cloud Foundry GPG key
curl -fsSL https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key | gpg --dearmor -o /usr/share/keyrings/cloudfoundry-keyring.gpg

# Add the Cloud Foundry repository
echo "deb [signed-by=/usr/share/keyrings/cloudfoundry-keyring.gpg] https://packages.cloudfoundry.org/debian stable main" | tee /etc/apt/sources.list.d/cloudfoundry.list

apt update > /dev/null 2>&1

# Install the Cloud Foundry CLI
apt install --yes cf8-cli

# Verify installation
cf8 version

Enterprise Linux and Fedora systems (RHEL6/CentOS6 and up):

# ...first configure the Cloud Foundry Foundation package repository
sudo wget -O /etc/yum.repos.d/cloudfoundry-cli.repo https://packages.cloudfoundry.org/fedora/cloudfoundry-cli.repo
# ...then, install the cf CLI (which will also download and add the public key to your system)
sudo yum install cf8-cli

Installers and compressed binaries

	Mac OS X 64 bit	Windows 64 bit	Linux 64 bit
Installers	Intel / arm	zip	rpm / deb
Binaries	Intel / arm	zip	tgz

Release notes, and 32 bit releases can be found here.

Download examples with curl for Mac OS X and Linux binaries

# ...download & extract Mac OS X binary
curl -L "https://packages.cloudfoundry.org/stable?release=macosx64-binary&version=v8&source=github" | tar -zx
# ...or Linux 64-bit binary
curl -L "https://packages.cloudfoundry.org/stable?release=linux64-binary&version=v8&source=github" | tar -zx
# ...move it (and the "cf" symlink which points to it) to /usr/local/bin or a location you know is in your $PATH
mv cf8 /usr/local/bin
mv cf /usr/local/bin
# ...copy tab completion file on Ubuntu (takes affect after re-opening your shell)
sudo curl -o /usr/share/bash-completion/completions/cf8 https://raw.githubusercontent.com/cloudfoundry/cli-ci/master/ci/installers/completion/cf8
# ...and to confirm your cf CLI version
cf version

Edge binaries

Edge binaries are not intended for wider use; they're for developers to test new features and fixes as they are 'pushed' and passed through the CI. Follow these download links for Mac OS X 64 bit, Windows 64 bit and Linux 64 bit.