The official command line client for Cloud Foundry.
View the latest help for The v7 CLI -OR- The v6 CLI, or run cf help -a
to view the help for all commands available in your currently installed version.
Sections: Getting Started | Download | Known Issues | Bugs/Feature Requests | Plugin Development | Contributing
Download and install the cf CLI from the Downloads Section for either the v7 cf CLI or the v6 cf CLI.
Once installed, you can log in and push an app. There are now two supported versions of the cf CLI:
- The v7 cf CLI is backed by the v3 CC API (with the exception of plugins which will be migrated in the next major release). See our v7 documentation for more information.
- The v6 cf CLI is backed by the v2 CC API See our v6 documentation for more information.
Please read the contributors' guide
If you'd like to submit updated translations, please see the i18n README for instructions on how to submit an update.
- You can pull down the GA release of the v7 cf CLI and/or the latest v6 cf CLI via our supported package managers using the same processes that were in place prior to the v7 GA (no changes are required initially)
- If you've been pulling down the v7 CF CLI beta previously, you will notice that there is now a symlink from
cf
to the existingcf7
binary. - See our Version Switching Guide for instructions on how to support workflows which require switching back and forth between v7 and v6
A Note About Support:
Now that the v7 cf CLI is GA, all new features, enhancements, and fixes will be made on the v7 line.
The v7 CLI's minimum supported version of the CC API is v3.85.0
(published in CAPI release v1.95.0).
The v7 CLI's minimum supported version of the CF-Deployment is v13.5.0
.
Going forward, the v6 CLI will only be updated to resolve the most severe defects and/or security issues.
At some point in the future, the v2 CC API endpoint will be deprecated by CAPI (see the v2 CC API deprecation plan) and the v6 CLI will be incompatible CAPI once a capi-release
that deprecates the v2 endpoint has been published.
Until the v2 CC API is deprecated, you can expect the v6 CLI to be fully functional, however, the CLI team's CI/CD resources are now focused on the v7 CLI so the v6 CLIs official maximum supported version of the CC APIs are now capped at v2.149.0
and v3.84.0
(published in CAPI release v1.94.0), and the V6 CLIs official maximum supported version of the CF-Deployment is now capped at v13.4.0
.
The v6 CLI's minimum supported version of the CF-Deployment is v7.0.0
. If you are on an older version of CF Deployment, we recommend you upgrade to CF-Deployment v7.0.0+.
If you have any questions, ask away on the #cli channel in our Slack community and the cf-dev mailing list, or open a GitHub issue. You can follow our development progress on Core CF CLI Pivotal Tracker.
Need to switch back and forth between CLI versions? See the Version Switching section for instructions.
Check out our community contributed CLI plugins to further enhance your CLI experience.
- On Windows in Cygwin and Git Bash, interactive password prompts (in
cf login
) do not hide the password properly from stdout (issue #1835). Please use an alternative command (non-interactive authenticationcf auth
instead ofcf login
) to work around this. Or, use the Windowscmd
command line. - On Windows,
cf ssh
may not display correctly if theTERM
is not set. We've found that settingTERM
tomsys
fixes some of these issues. - On Windows,
cf ssh
will hang when run from the MINGW32 or MINGW64 shell. A workaround is to use PowerShell instead. - CF CLI/GoLang do not use OpenSSL. Custom/Self Signed Certificates need to be installed in specific locations in order to
login
/auth
without--skip-ssl-validation
. - API tracing to terminal (using
CF_TRACE=true
,-v
option orcf config --trace
) doesn't work well with some CLI plugin commands. Trace to file works fine. On Linux,CF_TRACE=/dev/stdout
works too. See this Diego-Enabler plugin issue for more information. - .cfignore used in
cf push
must be in UTF-8 encoding for CLI to interpret correctly. (issue #281) - On Linux, when encountering message "bash: .cf: No such file or directory", ensure that you're using the correct binary or installer for your architecture.
First, update to the latest cli and try the command again.
If the error remains or feature still missing, check the open issues and if not already raised please file a new issue with the requested details.
The CF CLI supports external code execution via the plugins API. For more information follow:
When importing the plugin code use import "code.cloudfoundry.org/cli/plugin"
.
Older plugins that import github.com/cloudfoundry/cli/plugin
will still work
as long they vendor the plugins directory.