quick-start.rst

title:	Quick Start
description:	How to start provisioning a multi-node Deis cluster

Quick Start

These steps will help you get started with deploying a multi-node Deis cluster.

Generate an SSH key

To avoid problems deploying/launching apps later on, it is necessary to install CoreOS to disk with an SSH key without a passphrase. The following command will generate a new keypair named "deis":

$ ssh-keygen -q -t rsa -f ~/.ssh/deis -N '' -C deis

Generate a New Discovery URL

To get started with provisioning Deis, we will need to generate a new Discovery URL. Discovery URLs help connect etcd instances together by storing a list of peer addresses and metadata under a unique address. You can generate a new discovery URL for use in your platform by running the following from the root of the repository:

$ make discovery-url

This will write a new discovery URL to the user-data file. Some essential scripts are supplied in this user-data file, so it is mandatory for provisioning Deis.

Choose a Provider

Choose one of the following providers and deploy a new cluster:

• :ref:`deis_on_digitalocean`
• :ref:`deis_on_aws`
• :ref:`deis_on_vagrant`
• :ref:`deis_on_gce`
• :ref:`deis_on_rackspace`
• :ref:`deis_on_bare_metal`

Configure DNS

See :ref:`configure-dns` for more information on properly setting up your DNS records with Deis.

Install Deis Platform

Now that you've finished provisioning a cluster, please refer to :ref:`install_deisctl` and :ref:`install_deis_platform` to start the platform.