Version 1

This documentation is for Deis v1 PaaS. For Workflow (v2) documentation visit https://deis.com/docs/workflow/.

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
1.13.4

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

Note

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):

$ export DEISCTL_TUNNEL=104.131.93.162

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

$ export DEISCTL_TUNNEL="deis-1.example.com"

Note

For Vagrant clusters: export DEISCTL_TUNNEL=172.17.8.100

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

Note

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 domain=example.com

Note

For Vagrant clusters: deisctl config platform set domain=local3.deisapp.com

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.