• Manage Users and Roles
  • Push an App
  • Manage User-Provided Service Instances

It’s also called a command-line terminal, abbreviated as CLI. Information here is often used in interview questions. Open Terminal (several ways) On the Mac, the Terminal app is kinda buried, probably perhaps because those who use a MacOS laptop just for social media probably won’t need a Terminal. Recommended – Uninstall AWS CLI version 1 and use only AWS CLI version 2. For uninstall instructions, determine the method you used to install AWS CLI version 1 and follow the appropriate uninstall instructions for your operating system in Installing the AWS CLI version 1. The following steps enable you to install the AWS CLI version 1 from the command line on any build of macOS. The following is a summary of the installation commands that you can cut and paste to run as a single set of commands.

Page last updated:

This topic describes configuring and getting started with the Cloud Foundry Command Line Interface (cf CLI).

Cf cli plugins

Overview

The cf CLI is the official command line client for Cloud Foundry.You can use the cf CLI to manage apps, service instances, orgs, spaces, and usersin your environment.

Cf Cli Download For Mac

Prerequisite

To do the procedures in this topic, you must download and install the latest version of the cf CLI. For more information, see Installing the Cloud Foundry Command Line Interface.

Log In With the CLI

The cf login command uses the syntax described below to specify a target API endpoint, login credentials, an org, and a space.

The cf CLI prompts for credentials as needed. If you are a member of multiple orgs or spaces, cf login prompts you for which ones to log in to. Otherwise, it targets your org and space automatically.

To log in to the cf CLI:

  1. Run:

    Where:

    • API-URL is your API endpoint, the URL of the Cloud Controller in your Cloud Foundry instance.
    • USERNAME is your username.
    • PASSWORD is your password. Cloud Foundry discourages using the -p option, as it may record your password in your shell history.
    • ORG is the org where you want to deploy your apps.
    • SPACE is the space in the org where you want to deploy your apps.

When you successfully log in, you see output like the example below:

Log In With the API

You can write a script to log in to the cf CLI. This allows you to avoid manually logging in to the cf CLI each time you use it.

To write a script to log in:

  1. Target your API by running:

    Where API-URL is your API endpoint, the URL of the Cloud Controller in your Cloud Foundry instance.
    For more information, see api in the Cloud Foundry CLI Reference Guide.

  2. Authenticate by running:

    Where:

    • USERNAME is your username.
    • PASSWORD is your password. Cloud Foundry discourages using the -p option,because it may record your password in your shell history.
      For more information, see auth in the Cloud Foundry CLI Reference Guide.

  3. Target your org or space by running:

    Where:

    • ORG is the org you want to target.
    • SPACE is the space you want to target.
      For more information, see target in the Cloud Foundry CLI Reference Guide.

After you log in, the cf CLI saves a config.json file that contains your API endpoint, org, space values, and access token.

If you change these settings, the config.json file is updated accordingly.

By default, config.json is located in the ~/.cf directory. You can relocate the config.json file using the CF_HOME environment variable.

Localize the CLI

Cf Cli Commands

The cf CLI translates terminal output into the language that you select. The default language is en-US.

The cf CLI supports these languages:

  • Chinese (simplified): zh-Hans
  • Chinese (traditional): zh-Hant
  • English: en-US
  • French: fr-FR
  • German: de-DE
  • Italian: it-IT
  • Japanese: ja-JP
  • Korean: ko-KR
  • Portuguese (Brazil): pt-BR
  • Spanish: es-ES

For more information, see config in the Cloud Foundry CLI Reference Guide.

Note: Localization with cf config --locale affects only messages that the cf CLI generates.

To set the language of the cf CLI:

  1. Log in to the cf CLI:

  2. Run:

    Where LANGUAGE is code of the language you want to set.

  3. Confirm the language change by running:

    The command returns output similar to the example below:

Manage Users and Roles

The cf CLI includes commands that list users and assign roles in orgs and spaces.

List Users

To list all users in an org or a space:

  1. Log in to the cf CLI:

  2. Run one of these commands:

    • To list org users, run:
    • To list space users, run:

The command returns output similar to the example below:

For more information, see org-users and space-users in the Cloud Foundry CLI Reference Guide.

Windows

Manage Roles

You use the commands listed below to manage roles in the cf CLI.These commands require admin permissions and take username,org or space, and role as arguments:

  • cf set-org-role
    For more information, see set-org-role in the Cloud Foundry CLI Reference Guide.

  • cf unset-org-role
    For more information, see unset-org-role in the Cloud Foundry CLI Reference Guide.

  • cf set-space-role
    For more information, see set-space-role in the Cloud Foundry CLI Reference Guide.

  • cf unset-space-role
    For more information, see unset-space-role in the Cloud Foundry CLI Reference Guide.

The available roles are:

  • OrgManager
  • BillingManager
  • OrgAuditor
  • SpaceManager
  • SpaceDeveloper
  • SpaceAuditor

For more information about user roles, see Orgs, Spaces, Roles, and Permissions.

The example below shows the cf CLI output for assigning the Org Manager role to a user within an org:

Note: If you are not an admin, you see this message when you try to run these commands: error code: 10003, message: You are not authorized to perform the requested action

Manage Roles for Users with Identical Usernames in Multiple Origins

If a username corresponds to multiple accounts from different user stores, such as both the internal UAA store and an external SAML or LDAP store, the cf set-org-role and the cf unset-org-role commands above return this error:

To resolve this ambiguity, you can construct a curl command that uses the API to perform the desired role management function. For an example, see Associate Auditor with the Organization by Username in the Cloud Foundry API documentation.

Push an App

These sections describe how to use the cf push command to push a new app or sync changes to an existing app.

For more information, see push in the Cloud Foundry CLI Reference Guide.

Push a New App or Push Changes to an App

To push an app:

  1. Log in to the cf CLI by running:

  2. Navigate to the directory of the app.

  3. Push a new app or push changes to an app by running:

    Where APP-NAME is the name of the app.

Push an App Using a Manifest

You can provide a path to a manifest file when you push an app. The manifest file may include information such as the name of the app, disk limit, and number of instances. You can use a manifest file rather than adding flags to the cf push command.

cf push locates the manifest.yml file in the current working directory by default. Or, you can provide a path to the manifest with the -f flag.

For more information about the -f flag, see push in the Cloud Foundry CLI Reference Guide.

Note: When you provide an app name at the command line, cf push uses that app name whether or not there is a different app name in the manifest. If the manifest describes multiple apps, you can push a single app by providing its name at the command line; the cf CLI does not push the others. Use these behaviors for testing.

Push an App with a Buildpack

You can specify a buildpack when you push an app with the -b flag. If you use the -b flag to specify a buildpack, the app remains permanently linked to that buildpack. To use the app with a different buildpack, you must delete the app and then push it again.

For more information about available buildpacks, see Buildpacks.

The example below pushes an app called awesome-app to the URL http://awesome-app.example.com and specifies the Ruby buildpack with the -b flag:

Map a Route to an App

You can provide a hostname for your app when you push the app. If you do not provide a hostname, the cf push command routes your app to a URL of the form APP-NAME.DOMAIN, where APP-NAME is the name of your app and DOMAIN is your default domain.

For information about mapping a route to your app, see Routes and Domains.

To map a route to the app:

  1. Log in to the cf CLI by running:

  2. Map a route by running:

    Where:

    • APP-NAME is the name of the app.
    • APP-HOSTNAME is the hostname of the app.

Manage User-Provided Service Instances

These sections describe how to create or update a service instance.

Downloader For Mac

Create a Service Instance

To create a new service instance, use the cf create-user-provided-service or cf cups commands. For more information, see create-user-provided-service in the Cloud Foundry CLI Reference Guide.

Cf Cli Download For Mac Download

To create or update a user-provided service instance, you must supply basic parameters. For example, a database service might require a username, password, host, port, and database name.

You can provide these parameters in these ways:

  • Interactively. For more information, see Supply Parameters Interactively.

  • Non-interactively. For more information, see Supply Parameters Non-Interactively.

  • With third-party log management software as described in RFC 6587. For more information, see Supply Parameters Through a Third Party and RFC 6587.

    Note: When used with third-party logging, the cf CLI sends data formatted according to RFC 5424. For more information, see RFC 5424.

Supply Parameters Interactively

To create a new service while supplying parameters interactively:

  1. Log in to the cf CLI by running:

  2. List parameters in a comma-separated list after the -p flag. Run:

    Where:

    • SERVICE is the name of the service you want to create.
    • PARAMETER, SECOND-PARAMETER, and THIRD-PARAMETER are parameters such as username, password, host, port, and database name.

Supply Parameters Non-Interactively

To create a new service while supplying parameters non-interactively:

  1. Log in to the cf CLI by running:

  2. Pass parameters and their values in as a JSON hash, bound by single quotes, after the -p tag. Run:

    Where:

    • SERVICE is the name of the service you want to create.
    • HOSTNAME and PORT are service parameters.

Supply Parameters Through a Third Party

For specific log service instructions, see Service-Specific Instructions for Streaming App Logs.

To create a service instance that sends data to a third party:

  1. Log in to the cf CLI:

  2. Create a service instance that sends data to a third party by running:

    Where:

    • SERVICE is the name of the service you want to create.
    • THIRD-PARTY-DESTINATION-URL is the external URL of the third-party service.

Bind and Unbind Service Instances

After you create a user-provided service instance, you can:

  • Bind the service to an app with cf bind-service. For more information, see bind-service in the Cloud Foundry CLI Reference Guide.

  • Unbind the service with cf unbind-service. For more information, see unbind-service in the Cloud Foundry CLI Reference Guide.

  • Rename the service with cf rename-service. For more information, see rename-service in the Cloud Foundry CLI Reference Guide.

  • Delete the service with cf delete-service. For more information, see delete-service in the Cloud Foundry CLI Reference Guide.

Update a Service Instance

To update one or more of the parameters for an existing user-provided service instance, use cf update-user-provided-service or cf uups.

For more information, see update-user-provided-service in the Cloud Foundry CLI Reference Guide.

Note: The cf uups command does not update any parameter values that you do not supply.

Retrieve cf CLI Return Codes

The cf CLI uses exit codes, which help with scripting and confirming that a command has run successfully.

To view a cf CLI exit code:

  1. Log in to the cf CLI by running:

  2. To check that the login was successful, run one of these commands, depending on your OS:

    • For Mac OS, run:

    • For Windows, run:

If the command succeeds, the exit code is 0.

View CLI Help Output

The cf help command lists the cf CLI commands and a brief description of each. For more information, see help in the Cloud Foundry CLI Reference Guide.

To list detailed help for any cf CLI command, add the -h flag to the command.

The example below shows detailed help output for the cf delete command:

Create a pull request or raise an issue on the source for this page in GitHub

Downloading the latest V6 CF CLI

Installing using a package manager

Cf Cli Download

Mac OS X and Linux using Homebrew via the cloudfoundry tap:

Note:cf tab completion requires bash-completion to be installed properly in order to work.

Debian and Ubuntu based Linux distributions:

Enterprise Linux and Fedora systems (RHEL6/CentOS6 and up):

Installers and compressed binaries

Mac OS X 64 bitWindows 64 bitLinux 64 bit
Installerspkgziprpm / deb
Binariestgzziptgz

Release notes, and 32 bit releases can be found here.

Download examples with curl for Mac OS X and Linux binaries

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.

⇐ ⇐ Windows 10 Image Download Mac
⇒ ⇒ Hap Quicktime Codec Mac Download