Install and Configure Spinnaker

Describes how to install and set up Spinnaker so that it can be configured for use in production.

This section describes how to install and set up Spinnaker so that it can be configured for use in production. If you just want to evaluate Spinnaker without much work, one of the options in Quickstart might be a better choice.

What you’ll need

  • A machine on which to install Halyard

    This can be a local machine or VM (Ubuntu 18.04 or higher, Debian 10 or higher), or it can be a Docker container. Make sure it has at least 12GB of memory.

  • A Kubernetes cluster on which to install Spinnaker itself

    We recommend at least 4 cores and 16GB of RAM available in the cluster.

You can also install on a single local machine , or for Spinnaker development , making sure you have the 4 cores and 16GB in each case.

The process

Installing a complete Spinnaker involves these steps:

  1. Install Halyard
  2. Choose a cloud provider
  3. Choose an environment
  4. Choose a storage service
  5. Deploy Spinnaker
  6. Back up your config
  7. Configure everything else (which includes a lot of stuff you need before you can use Spinnaker in production)
  8. Productionize Spinnaker (which mainly helps you configure Spinnaker to scale for production)

And then what?

Get started using Spinnaker

Install Halyard

Cloud Providers Overview

In Spinnaker, providers are integrations to the Cloud platforms you deploy your applications to.

Choose your Environment

Based on your use case, choose how you want to install Spinnaker.

External Storage

Spinnaker requires an external storage provider for persisting your Application settings and configured Pipelines.

Deploy Spinnaker and Connect to the UI

After you finish configuring Spinnaker, deploy it and connect to the Deck, the Spinnaker UI.

Back Up Your Config

Create a backup of your Halyard config so that you can redeploy Spinnaker any time with the same configurations.

Halyard FAQ

Common questions about Halyard.


Spinnaker configuration is a multipart process, including configuring Cloud providers as deployment targets and external storage for metadata persistence.


Upgrading Spinnaker is a two step process. First, select the target version. Then, apply your change.