Get monitoring, observability, online education,
and expert support from Lightbend.
Learn More

Preparing a development environment

To develop and deploy Cloudflow applications, you will need a Java SDK (JDK), Docker, a Kubernetes cluster, the sbt build tool, and the Cloudflow CLI, which is an extension for kubectl.

This page describes the required environment to prepare for development. Please see Installing Cloudflow for instructions on how to install Cloudflow on a Kubernetes cluster.


First, make sure that you have the following installed:

  • Java(JDK) >= 8

  • sbt, version 1.2.8 or higher

  • Docker, version 18.09 or higher

  • Helm, version 3 or higher. We recommend version 3 to avoid dealing with tiller.

  • kubectl

Download and install the Cloudflow CLI

Using one of the links below, download the Cloudflow CLI appropriate for your development platform. Install it on your local system by unzipping the archive and moving the executable into your PATH.

Please make sure you have the executable in your path with proper permission settings. For Linux or MacOS, put the executables in /usr/local/bin with permission settings of 755.

On MacOS Catalina and later, the default behavior is to not allow unsigned executables downloaded from the internet. It is planned to sign the executable with an Apple developer certificate to fix this but, in the mean time, there is a very simple workaround. After downloading and unpacking the executable, please execute the following command to remove the "downloaded from the internet" filesystem flag that blocks the file from being executed:


xattr -d [path to]/kubectl-cloudflow

+ More details can be found in the associated issue.

What’s next

Let’s get an overview of the Wind Turbine example.