Installing Armory Spinnaker

Try Armory’s Demo Environment

You can try our Demo Environment before installing Armory.

Installing Armory Halyard

You can install Armory’s version of Halyard directly on Mac OSX, or use Docker to run Halyard and its command line.

On Mac OSX

Before You Start

The current installer requires your kubectl to be version 1.10 or greater.

Our installer currently expects to use your kubectl to find your current configuration (usually stored in ~/.kube/config). Ensure that the config file kubectl defaults to is the one you want to use.


You can download the installer and run it with this command:

curl -L > && sudo bash --version latest

This should install the hal command in /usr/local/bin. You can test that you have the correct version in your path by running hal armory and see a help screen that includes a SUBCOMMANDS section with at least an init option that “Runs Armory installer”:

$ hal armory

    Runs Armory installer

From there, you can issue all your halyard commands.

Using Docker

Before You Start

The Docker image will contain most of the files you will need. However, you may need to update your .kube/config file to use heptio-authenticator-aws instead of aws-iam-authenticator; although both are compatible, the Docker container expects to use the former.

If the .hal directory you map in the docker command below already exist, make sure you have write permission to that directory (and read permissions to the others). If the directory doesn’t exist, it will be created by the docker container.

Our installer currently expects to find your kubeconfig named config in the .kube directory you map below. If you’ve named your config something else, you’ll need to rename or symlink the file accordingly.


You can start Armory Halyard in a Docker container with the following command:

docker run --name armory-halyard --rm \
    -v ~/.hal:/home/spinnaker/.hal \
    -v ~/.kube:/home/spinnaker/.kube \
    -v ~/.aws:/home/spinnaker/.aws \

Once Armory Halyard is running, you can interact with it by opening a separate Terminal and running:

docker exec -it armory-halyard bash

From there, you can issue all your halyard commands.

Installing Armory Spinnaker

With Armory’s version of Halyard installed, you can install Armory Spinnaker with the command:

$ hal armory init

This will download the Armory installer and walk you through the initial installation of Spinnaker. You’ll need to have a kubectl file already set up to use Amazon EKS, and your AWS credentials file handy.

The installer will walk you through the selection of clusters, the region and bucket names for S3 storage, and the creation of service accounts; finally, it will set up the pods to run Spinnaker and then provide you a proxy to interact with.

Options for hal armory init.

Notes on Docker

You will not be able to access the proxy in the Docker container from your machine directly, so you’ll need to install kubectl natively on your system and then run the following two commands:

kubectl -n ${SPINNAKER_NAMESPACE} port-forward services/spin-deck 9000:9000 &
kubectl -n ${SPINNAKER_NAMESPACE} port-forward services/spin-gate 8084:8084 &

You should then be able to connect to http://localhost:9000/ with your browser and use your newly installed Spinnaker.