Kitura Logo


This guide will show you how to deploy the Kitura application you created by following our Getting Started guide to a Cloud Foundry based cloud environment. The guide assumes you already have an environment to deploy to. If not, you can sign up to IBM Cloud for free and use it to host your Cloud Foundry apps.

Starter project contents

Your generated Kitura project contains a manifest.yml file which you can use to deploy your application. Although you can deploy applications without a manifest, manifests provide consistency and reproducibility across deployments. You can also specify additional application attributes within your manifest. You’ll use the Cloud Foundry command line interface, which you can install using the instructions here.

Deploy to Cloud Foundry

To push your application, you first need to consult your cloud operator to find the URL you need to target. You can set it in the command line like this:

cf login -a <API endpoint>

You’ll also need to provide your username and password when prompted. Next, you’ll need to find the organisation and space you are pushing to, and target them like this:

cf target -o <organisation> -s <space>

Now, you’re ready to push your app. Simply run the following command from the same location as your manifest.yml:

cf push

Your Kitura application should now be successfully deployed into your Cloud Foundry environment! If you haven’t edited the manifest.yml file, it will have been assigned a random route. If you visit this URL you should see the Kitura splash page.

Slack icon