Difficulty: Beginner
Estimated Time: 30

Do you want to try Cloud Foundry but don’t know where to begin? This tutorial provides a brief introduction to deploying and managing applications on the Cloud Foundry platform.

You will:

  • Deploy an application to Cloud Foundry
  • Provision a database and make it available to your app
  • Scale the application
  • Observe some of the resiliency of Cloud Foundry by killing an app instance

Important Notes

We have have provisioned an environment for you to complete this tutorial. You have 30 minutes from now to complete this tutorial after which time the Cloud Foundry environment and account will be destroyed. If you try to do something with Cloud Foundry after 30 minutes, you will see an error like The token expired, was revoked, or the token ID is incorrect. Please log back in to re-authenticate. You can restart the tutorial after 30 minutes to receive a new environment.

Provisioning can take up to a minute to complete. Please be sure you see a message in the terminal telling you to proceed before attempting the tutorial.

This content scenario is currently in beta. If you have an issue with provisioning or any part of the exercise, please restart the scenario. We are working to improve the experience.

Next Steps

Thanks for taking the time to Try Cloud Foundry and welcome to the massive community of users. Please take a few minutes to complete our short survey.

We welcome you to complete more tutorials at tutorials.cloudfoundry.org and get involved.

Try Cloud Foundry on Kubernetes

Step 1 of 7

The Command Line Interface


The CLI, or Command Line Interface, is the tool you will use to interact with Cloud Foundry. The CLI runs in a terminal window and makes REST calls to the Cloud Foundry API. The CLI has been preinstalled in the terminal window.

You can verify this by checking the version:

cf version


The CLI is a self-documenting tool. For example, you can run:

  • cf help to see a list of the most commonly used commands
  • cf help -a to see a list of all the available commands
  • cf <command> --help to see details on using a specific command

Logging in

Note: We have already created a user account and space to complete this tutorial in an existing Cloud Foundry instance.

When using a Cloud Foundry instance, you first need to login. We have already logged you into the Cloud Foundry instance using the user account generated for you. You can see the details of this instance by running:

cf target

Now that you are logged in, you are ready to deploy an application.