Deploy Spinnaker and Connect to the UI

Now that we’ve enabled one or more Cloud Providers, picked a Deployment Environment, and configured Persistent Storage, we’re ready to pick a version of Spinnaker, deploy it, and connect to it.

Pick a version

  1. List the available versions:

    hal version list

    You can follow the links to the versions’ respective changelogs to see what features each adds.

  2. Set the version you want to use:

    hal config version edit --version $VERSION

Deploy Spinnaker

hal deploy apply

Note: If you’re deploying to your local machine, you might need sudo hal deploy apply.

Connect to the Spinnaker UI

  1. Run the following command:

    hal deploy connect

    If necessary, set up an SSH tunnel to the host running Halyard.

    This command automatically forwards ports 9000 (Deck UI) and 8084 (Gate API service).

  2. Navigate to localhost:9000.


  • You can make Spinnaker publicly reachable without running this command, as described here (for local Debian) and here (for Kubernetes).

  • You can set up authentication.


If this command fails, and it’s the first time you’ve run this command please reach out to us on Slack. If you’ve had a successful deployment, you can run hal deploy diff to see what changes you’ve made that may be causing problems. At any point you can rerun hal deploy apply with any changes you’ve made to retry the deployment.

Upgrade Spinnaker

If you want to change Spinnaker versions using Halyard, you can read about supported versions like so:

hal version list

And pick a new version like so:

hal config version edit --version $VERSION

# this will update Spinnaker
hal deploy apply

Next steps

Now that Spinnaker is deployed and capable managing your cloud provider, you can…

You might also want to back up your configuration.