Version 1

This documentation is for Deis v1 PaaS. For Workflow (v2) documentation visit

Install the Deis Platform

We will use the deisctl utility to provision the Deis platform from a CoreOS host or a workstation that has SSH access to CoreOS.

First check that you have deisctl installed and the version is correct.

$ deisctl --version

If not, follow instructions to Install deisctl.

Ensure your SSH agent is running and select the private key that corresponds to the SSH key added to your CoreOS nodes:

$ eval `ssh-agent -s`
$ ssh-add ~/.ssh/deis


For Vagrant clusters: ssh-add ~/.vagrant.d/insecure_private_key

Find the public IP address of one of your nodes, and export it to the DEISCTL_TUNNEL environment variable (substituting your own IP address):


If you set up the “convenience” DNS records, you can just refer to them via

$ export DEISCTL_TUNNEL=""


For Vagrant clusters: export DEISCTL_TUNNEL=

This is the IP address where deisctl will attempt to communicate with the cluster. You can test that it is working properly by running deisctl list. If you see a single line of output, the control utility is communicating with the nodes.

Before provisioning the platform, we’ll need to add the SSH key to Deis so it can connect to remote hosts during deis run:

$ deisctl config platform set sshPrivateKey=~/.ssh/deis


For Vagrant clusters: deisctl config platform set sshPrivateKey=${HOME}/.vagrant.d/insecure_private_key

We’ll also need to tell the controller which domain name we are deploying applications under:

$ deisctl config platform set


For Vagrant clusters: deisctl config platform set

Once finished, run this command to provision the Deis platform:

$ deisctl install platform

You will see output like the following, which indicates that the units required to run Deis have been loaded on the CoreOS cluster:

● ▴ ■
■ ● ▴ Installing Deis...
▴ ■ ●

Scheduling data containers...
Deis installed.
Please run `deisctl start platform` to boot up Deis.

Run this command to start the Deis platform:

$ deisctl start platform

Once you see “Deis started.”, your Deis platform is running on a cluster! You may verify that all of the Deis units are loaded and active by running the following command:

$ deisctl list

All of the units should be active.

Now that you’ve finished provisioning a cluster, please refer to Using Deis to get started using the platform.