-
Notifications
You must be signed in to change notification settings - Fork 929
V7 CLI Installation Guide
Important Note: The v7 CF CLI binary is named cf7
with a symlink cf
which points to it so CLI commands can be invoked using either cf
or cf7
.
If you're already using the v7 CLI in parallel to the v6 CLI (using cf
to invoke v6 and cf7
to invoke v7), you may need to change your workflow. See the Version Switching Guide for instructions. For more information and general status on the v7 CLI, please check releases.
The v7 CLI's minimum supported version of the CC API is v3.85.0
(published in CAPI release v1.95.0).
See the releases page for the minimum CAPI versions required for each v7 release.
Mac OS X and Linux using Homebrew via the cloudfoundry tap:
brew install cloudfoundry/tap/cf-cli@7
Note: cf
tab completion requires bash-completion
to be installed properly in order to work.
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 cf7-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 cf7-cli
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=v7&source=github" | tar -zx
# ...or Linux 64-bit binary
curl -L "https://packages.cloudfoundry.org/stable?release=linux64-binary&version=v7&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 cf7 /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/cf7 https://raw.githubusercontent.com/cloudfoundry/cli-ci/master/ci/installers/completion/cf7
# ...and to confirm your cf CLI version
cf version
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.