The official command line client for Cloud Foundry.
View the latest help for The v8 CLI -OR- The v7 CLI, or run cf help -a
to view the help for all commands available in your currently installed version.
CF CLI Binary Download Server's uptime:
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 v8 cf CLI or the v7 cf CLI.
Once installed, you can log in and push an app. There are now three supported versions of the cf CLI:
View our CLI v7 & v8 Versioning and Support Policy documentation.
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.
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.
Check out our community contributed CLI plugins to further enhance your CLI experience.
Note: For most up-to-date information in issues and workarounds please review the open and closed github issues
cf login
) do not hide the password properly from stdout (issue #1835). Please use an alternative command (non-interactive authentication cf auth
instead of cf login
) to work around this. Or, use the Windows cmd
command line.cf ssh
may not display correctly if the TERM
is not set. We've found that setting TERM
to msys
fixes some of these issues.cf ssh
will hang when run from the MINGW32 or MINGW64 shell. A workaround is to use PowerShell instead.login
/auth
without --skip-ssl-validation
.CF_TRACE=true
, -v
option or cf 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.cf push
must be in UTF-8 encoding for CLI to interpret correctly. (issue #281)stdout
, if that's an inconvenience you could set CF_RAISE_ERROR_ON_WARNINGS
and in that case warnings will be printed through the stderr
. See X-Cf-Warnings printed through stdout issueFirst, 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.