Cloud Foundry CLI Reference Guide
- Name
- Usage
- Version
- Getting Started
- Apps
- Services
- Orgs
- Spaces
- Domains
- Routes
- Network Policies
- Buildpacks
- User Admin
- Org Admin
- Space Admin
- Service Admin
- Security Group
- Environment Variable Groups
- Isolation Segments
- Feature Flags
- Advanced
- Add/remove Plugin Repository
- Add/remove Plugin
- Environment Variables
- Global Options
- Apps (experimental)
Page last updated:
Warning: Pivotal Cloud Foundry (PCF) v2.3 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.
Name
cf - A command line tool to interact with Cloud Foundry
Usage
cf [global options] command [arguments…] [command options]
Version
6.39.1+efdd631d2.2018-09-18
Getting Started
| Command | Description |
|---|---|
| help | Show help |
| version | Print the version |
| login | Log user in |
| logout | Log user out |
| passwd | Change user password |
| target | Set or view the targeted org or space |
| api | Set or view target api url |
| auth | Authenticate non-interactively |
Apps
| Command | Description |
|---|---|
| apps | List all apps in the target space |
| app | Display health and status for an app |
| push | Push a new app or sync changes to an existing app |
| scale | Change or view the instance count, disk space limit, and memory limit for an app |
| delete | Delete an app |
| rename | Rename an app |
| start | Start an app |
| stop | Stop an app |
| restart | Stop all instances of the app, then start them again. This causes downtime. |
| restage | Recreate the app’s executable artifact using the latest pushed app files and the latest environment (variables, service bindings, buildpack, stack, etc.) |
| restart-app-instance | Terminate, then restart an app instance |
| run-task | Run a one-off task on an app |
| tasks | List tasks of an app |
| terminate-task | Terminate a running task of an app |
| events | Show recent app events |
| files | Print out a list of files in a directory or the contents of a specific file of an app running on the DEA backend |
| logs | Tail or show recent logs for an app |
| env | Show all env variables for an app |
| set-env | Set an env variable for an app |
| unset-env | Remove an env variable |
| stacks | List all stacks (a stack is a pre-built file system, including an operating system, that can run apps) |
| stack | Show information for a stack (a stack is a pre-built file system, including an operating system, that can run apps) |
| copy-source | Copies the source code of an application to another existing application (and restarts that application) |
| create-app-manifest | Create an app manifest for an app that has been pushed successfully |
| get-health-check | Show the type of health check performed on an app |
| set-health-check | Change type of health check performed on an app |
| enable-ssh | Enable ssh for the application |
| disable-ssh | Disable ssh for the application |
| ssh-enabled | Reports whether SSH is enabled on an application container instance |
| ssh | SSH to an application container instance |
Services
| Command | Description |
|---|---|
| marketplace | List available offerings in the marketplace |
| services | List all service instances in the target space |
| service | Show service instance info |
| create-service | Create a service instance |
| update-service | Update a service instance |
| delete-service | Delete a service instance |
| rename-service | Rename a service instance |
| create-service-key | Create key for a service instance |
| service-keys | List keys for a service instance |
| service-key | Show service key info |
| delete-service-key | Delete a service key |
| bind-service | Bind a service instance to an app |
| unbind-service | Unbind a service instance from an app |
| bind-route-service | Bind a service instance to an HTTP route |
| unbind-route-service | Unbind a service instance from an HTTP route |
| create-user-provided-service | Make a user-provided service instance available to CF apps |
| update-user-provided-service | Update user-provided service instance |
| share-service | Share a service instance with another space |
| unshare-service | Unshare a shared service instance from a space |
Orgs
| Command | Description |
|---|---|
| orgs | List all orgs |
| org | Show org info |
| create-org | Create an org |
| delete-org | Delete an org |
| rename-org | Rename an org |
Spaces
| Command | Description |
|---|---|
| spaces | List all spaces in an org |
| space | Show space info |
| create-space | Create a space |
| delete-space | Delete a space |
| rename-space | Rename a space |
| allow-space-ssh | Allow SSH access for the space |
| disallow-space-ssh | Disallow SSH access for the space |
| space-ssh-allowed | Reports whether SSH is allowed in a space |
Domains
| Command | Description |
|---|---|
| domains | List domains in the target org |
| create-domain | Create a domain in an org for later use |
| delete-domain | Delete a domain |
| create-shared-domain | Create a domain that can be used by all orgs (admin-only) |
| delete-shared-domain | Delete a shared domain |
| router-groups | List router groups |
Routes
| Command | Description |
|---|---|
| routes | List all routes in the current space or the current organization |
| create-route | Create a url route in a space for later use |
| check-route | Perform a simple check to determine whether a route currently exists or not |
| map-route | Add a url route to an app |
| unmap-route | Remove a url route from an app |
| delete-route | Delete a route |
| delete-orphaned-routes | Delete all orphaned routes (i.e. those that are not mapped to an app) |
Network Policies
| Command | Description |
|---|---|
| network-policies | List direct network traffic policies |
| add-network-policy | Create policy to allow direct network traffic from one app to another |
| remove-network-policy | Remove network traffic policy of an app |
Buildpacks
| Command | Description |
|---|---|
| buildpacks | List all buildpacks |
| create-buildpack | Create a buildpack |
| update-buildpack | Update a buildpack |
| rename-buildpack | Rename a buildpack |
| delete-buildpack | Delete a buildpack |
User Admin
| Command | Description |
|---|---|
| create-user | Create a new user |
| delete-user | Delete a user |
| org-users | Show org users by role |
| set-org-role | Assign an org role to a user |
| unset-org-role | Remove an org role from a user |
| space-users | Show space users by role |
| set-space-role | Assign a space role to a user |
| unset-space-role | Remove a space role from a user |
Org Admin
| Command | Description |
|---|---|
| quotas | List available usage quotas |
| quota | Show quota info |
| set-quota | Assign a quota to an org |
| create-quota | Define a new resource quota |
| delete-quota | Delete a quota |
| update-quota | Update an existing resource quota |
| share-private-domain | Share a private domain with an org |
| unshare-private-domain | Unshare a private domain with an org |
Space Admin
| Command | Description |
|---|---|
| space-quotas | List available space resource quotas |
| space-quota | Show space quota info |
| create-space-quota | Define a new space resource quota |
| update-space-quota | Update an existing space quota |
| delete-space-quota | Delete a space quota definition and unassign the space quota from all spaces |
| set-space-quota | Assign a space quota definition to a space |
| unset-space-quota | Unassign a quota from a space |
Service Admin
| Command | Description |
|---|---|
| service-auth-tokens | List service auth tokens |
| create-service-auth-token | Create a service auth token |
| update-service-auth-token | Update a service auth token |
| delete-service-auth-token | Delete a service auth token |
| service-brokers | List service brokers |
| create-service-broker | Create a service broker |
| update-service-broker | Update a service broker |
| delete-service-broker | Delete a service broker |
| rename-service-broker | Rename a service broker |
| migrate-service-instances | Migrate service instances from one service plan to another |
| purge-service-offering | Recursively remove a service and child objects from Cloud Foundry database without making requests to a service broker |
| purge-service-instance | Recursively remove a service instance and child objects from Cloud Foundry database without making requests to a service broker |
| service-access | List service access settings |
| enable-service-access | Enable access to a service or service plan for one or all orgs |
| disable-service-access | Disable access to a service or service plan for one or all orgs |
Security Group
| Command | Description |
|---|---|
| security-group | Show a single security group |
| security-groups | List all security groups |
| create-security-group | Create a security group |
| update-security-group | Update a security group |
| delete-security-group | Deletes a security group |
| bind-security-group | Bind a security group to a particular space, or all existing spaces of an org |
| unbind-security-group | Unbind a security group from a space |
| bind-staging-security-group | Bind a security group to the list of security groups to be used for staging applications |
| staging-security-groups | List security groups in the staging set for applications |
| unbind-staging-security-group | Unbind a security group from the set of security groups for staging applications |
| bind-running-security-group | Bind a security group to the list of security groups to be used for running applications |
| running-security-groups | List security groups in the set of security groups for running applications |
| unbind-running-security-group | Unbind a security group from the set of security groups for running applications |
Environment Variable Groups
| Command | Description |
|---|---|
| running-environment-variable-group | Retrieve the contents of the running environment variable group |
| staging-environment-variable-group | Retrieve the contents of the staging environment variable group |
| set-staging-environment-variable-group | Pass parameters as JSON to create a staging environment variable group |
| set-running-environment-variable-group | Pass parameters as JSON to create a running environment variable group |
Isolation Segments
| Command | Description |
|---|---|
| isolation-segments | List all isolation segments |
| create-isolation-segment | Create an isolation segment |
| delete-isolation-segment | Delete an isolation segment |
| enable-org-isolation | Entitle an organization to an isolation segment |
| disable-org-isolation | Revoke an organization’s entitlement to an isolation segment |
| set-org-default-isolation-segment | Set the default isolation segment used for apps in spaces in an org |
| reset-org-default-isolation-segment | Reset the default isolation segment used for apps in spaces of an org |
| set-space-isolation-segment | Assign the isolation segment for a space |
| reset-space-isolation-segment | Reset the space’s isolation segment to the org default |
Feature Flags
| Command | Description |
|---|---|
| feature-flags | Retrieve list of feature flags with status |
| feature-flag | Retrieve an individual feature flag with status |
| enable-feature-flag | Allow use of a feature |
| disable-feature-flag | Prevent use of a feature |
Advanced
| Command | Description |
|---|---|
| curl | Executes a request to the targeted API endpoint |
| config | Write default values to the config |
| oauth-token | Retrieve and display the OAuth token for the current session |
| ssh-code | Get a one time password for ssh clients |
Add/remove Plugin Repository
| Command | Description |
|---|---|
| add-plugin-repo | Add a new plugin repository |
| remove-plugin-repo | Remove a plugin repository |
| list-plugin-repos | List all the added plugin repositories |
| repo-plugins | List all available plugins in specified repository or in all added repositories |
Add/remove Plugin
| Command | Description |
|---|---|
| plugins | List commands of installed plugins |
| install-plugin | Install CLI plugin |
| uninstall-plugin | Uninstall CLI plugin |
Environment Variables
| Variable | Description |
|---|---|
| CF_COLOR=false | Do not colorize output |
| CF_DIAL_TIMEOUT=5 | Max wait time to establish a connection, including name resolution, in seconds |
| CF_HOME=path/to/dir/ | Override path to default config directory |
| CF_PLUGIN_HOME=path/to/dir/ | Override path to default plugin config directory |
| CF_TRACE=true | Print API request diagnostics to stdout |
| CF_TRACE=path/to/trace.log | Append API request diagnostics to a log file |
| all_proxy=proxy.example.com:8080 | Specify a proxy server to enable proxying for all requests |
| https_proxy=proxy.example.com:8080 | Enable proxying for HTTP requests |
Global Options
| Option | Description |
|---|---|
| –help, -h | Show help |
| -v | Print API request diagnostics to stdout |
Apps (experimental)
| Command | Description |
|---|---|
| v3-apps | List all apps in the target space |
| v3-create-app | Create a V3 App |
| v3-push | Push a new app or sync changes to an existing app |
| v3-scale | Change or view the instance count, disk space limit, and memory limit for an app |
| v3-delete | Delete a V3 App |
| v3-start | Start an app |
| v3-stop | Stop an app |
| v3-restart | Stop all instances of the app, then start them again. This causes downtime. |
| v3-stage | Create a new droplet for an app |
| v3-restart-app-instance | Terminate, then instantiate an app instance |
| v3-apply-manifest | Applies manifest properties to an application |
| v3-droplets | List droplets of an app |
| v3-set-droplet | Set the droplet used to run an app |
| v3-env | Show all env variables for an app |
| v3-set-env | Set an env variable for an app |
| v3-unset-env | Remove an env variable from an app |
| v3-get-health-check | Show the type of health check performed on an app |
| v3-set-health-check | Change type of health check performed on an app’s process |
| v3-packages | List packages of an app |
| v3-create-package | Uploads a V3 Package |
| v3-ssh | SSH to an application container instance |