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:

# ...first add the Cloud Foundry Foundation public key and package repository to your system
wget -q -O - https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key | sudo apt-key add -
echo "deb https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list
# ...then, update your local package index, then finally install the cf CLI
sudo apt-get update
sudo apt-get install cf8-cli

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 /user/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.