List the available versions:
hal version list
You can follow the links to the versions’ respective changelogs to see what features each adds.
Set the version you want to use:
hal config version edit --version $VERSION
hal deploy apply
Note: If you’re deploying to your local machine, you might need
sudo hal deploy apply.
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).
Navigate to localhost:9000 .
Note: Even if the
hal deploy apply command returns successfully, the
installation may not be complete yet. This is especially the case with
kubernetes distributed installs. If you see errors such as
it may be that all of the containers are not yet available. You can either wait,
or check the status of all of the containers using the commands for your cloud
provider (such as
kubectl get pods --namespace spinnaker).
If this command fails, and it’s the first time you’ve run this command please
reach out to us on
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.
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
Now that Spinnaker is deployed and capable managing your cloud provider, you can…
Continue with additional configuration, such as your image bakery
If you’re a Spinnaker end user, read how to get started using Spinnaker
Visit the Guides pages to learn more
You might also want to back up your configuration .