Install the Score implementation (CLI)

You can install a Score implementation (CLI) in a variety of ways.

Choose one of the following methods and a Score implementation tool to continue.

Install the Score CLI with brew

Using brew, you can install the Score implementation (CLI).

Prerequisites: You must have brew installed.

brew install score-spec/tap/score-compose

brew install score-spec/tap/score-helm

brew install score-spec/tap/score-humanitec

Install the Score CLI using Go

Using Go, you can fetch, compile, and install the Score implementation (CLI).

Prerequisites: You must have Go installed.

go install -v github.com/score-spec/score-compose/cmd/score-compose@latest

go install -v github.com/score-spec/score-helm/cmd/score-helm@latest

go install -v github.com/score-spec/score-humanitec/cmd/score-humanitec@latest

Install using Docker

This method will start and run a new Docker container based on the image provided.

Some Score Implementation CLI contain a Dockerfile for building a Docker container that runs the command line application.

To use this Dockerfile, first install Docker on your machine and run the application.

  1. Download the repository. The following example uses the GitHub CLI to download the project.
gh repo clone score-spec/score-compose
  1. Change directories into score-compose.
cd score-compose
  1. Build the Docker image by running the following command in the same directory as the Dockerfile.
docker build -t score-compose:latest .
  1. Run the Docker image by using the docker run command.
docker run -it score-compose:latest

If you want to run score-compose with the --help flag to view the available options, you would run the following command.

docker run -it score-compose:latest --help

This will start a new container based on the image you built, run score-compose with the --help flag, and then stop the container.

Some Score Implementation CLI contain a Dockerfile for building a Docker container that runs the command line application.

To use this Dockerfile, first install Docker on your machine and run the application.

  1. Download the repository. The following example uses the GitHub CLI to download the project.
gh repo clone score-spec/score-helm
  1. Change directories into score-helm.
cd score-helm
  1. Build the Docker image by running the following command in the same directory as the Dockerfile.
docker build -t score-helm:latest .
  1. Run the Docker image by using the docker run command.
docker run -it score-helm:latest

If you want to run score-helm with the --help flag to view the available options, you would run the following command.

docker run -it score-helm:latest --help

This will start a new container based on the image you built, run score-helm with the --help flag, and then stop the container.

Some Score Implementation CLI contain a Dockerfile for building a Docker container that runs the command line application.

To use this Dockerfile, first install Docker on your machine and run the application.

  1. Download the repository. The following example uses the GitHub CLI to download the project.
gh repo clone score-spec/score-humanitec
  1. Change directories into score-humanitec.
cd score-humanitec
  1. Build the Docker image by running the following command in the same directory as the Dockerfile.
docker build -t score-humanitec:latest .
  1. Run the Docker image by using the docker run command.
docker run -it score-humanitec:latest

If you want to run score-humanitec with the --help flag to view the available options, you would run the following command.

docker run -it score-humanitec:latest --help

This will start a new container based on the image you built, run score-humanitec with the --help flag, and then stop the container.

Install using a manual method

The following methods download a Score Implementation (CLI) from the project’s GitHub release page.

Install the binary with curl on macOS

Choose the Score Implementation you want to install.

Step 1. Download the latest release

curl -L0 "https://github.com/score-spec/score-compose/releases/download/0.2.0/score-compose_0.2.0_darwin_arm64.tar.gz" -o score-compose.tgz

Step 2. Unpack the latest release

tar xvzf score-compose.tgz

The following is the output of the previous command.

x LICENSE
x README.md
x score-compose

Step 3. Clean up the tar file

Clean up any unwanted files.

rm score-compose.tgz README.md LICENSE

Step 4. Move the binary to PATH

Move the score-compose binary to a file location on your system PATH.

sudo mv ./score-compose /usr/local/bin/score-compose
sudo chown root: /usr/local/bin/score-compose

Results You’ve successfully installed the Score implementation (CLI).

Step 1. Download the latest release

curl -L0 "https://github.com/score-spec/score-helm/releases/download/0.2.0/score-helm_0.2.0_darwin_arm64.tar.gz" -o score-helm.tgz

Step 2. Unpack the latest release

tar xvzf score-helm.tgz

The following is the output of the previous command.

x LICENSE
x README.md
x score-helm

Step 3. Clean up the tar file

Clean up any unwanted files.

rm score-helm.tgz README.md LICENSE

Step 4. Move the binary to PATH

Move the score-helm binary to a file location on your system PATH.

sudo mv ./score-helm /usr/local/bin/score-helm
sudo chown root: /usr/local/bin/score-helm

Results You’ve successfully installed the Score implementation (CLI).

Step 1. Download the latest release

curl -L0 "https://github.com/score-spec/score-humanitec/releases/download/0.2.0/score-humanitec_0.2.0_darwin_arm64.tar.gz" -o score-humanitec.tgz

Step 2. Unpack the latest release

tar xvzf score-humanitec.tgz

The following is the output of the previous command.

x LICENSE
x README.md
x score-humanitec

Step 3. Clean up the tar file

Clean up any unwanted files.

rm score-humanitec.tgz README.md LICENSE

Step 4. Move the binary to PATH

Move the score-humanitec binary to a file location on your system PATH.

sudo mv ./score-humanitec /usr/local/bin/score-humanitec
sudo chown root: /usr/local/bin/score-humanitec

Results You’ve successfully installed the Score implementation (CLI).

Install the binary with wget on macOS and Linux

Choose the Score Implementation you want to install.

Step 1. Download the latest release

Download with the CLI wget command.

wget https://github.com/score-spec/<score-platform>/releases/download/<x.y.z>/<score-platform>_<x.y.z>_<os_system>.tar.gz
  • Replace <score-platform> with the name of the Score implementation (CLI).
  • Replace <x.y.z> with the version number.
  • Replace <os_system> with your operating system.

For example, the following wget command downloads score-compose for macOS.

wget https://github.com/score-spec/score-compose/releases/download/0.2.0/score-compose_0.2.0_darwin_arm64.tar.gz

Results You should see something similar to the following output.

Saving to: `<score-platform>_<x.y.z>_<os_system>.tar.gz`

score-compose_<x.y.z> 100%[===================>]   2.85M  5.28MB/s    in 0.5s

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file.

tar -xvzf ~/<your-path>/<score-platform>_<x.y.z>_<os_system>.tar.gz

Results You should see the following output.

x LICENSE
x README.md
x score-compose

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-compose --version

The command returns the following output.

score-compose <x.y.z>

Results You’ve successfully installed the Score implementation tool.

Step 1. Download the latest release

Download with the CLI wget command.

wget https://github.com/score-spec/<score-platform>/releases/download/<x.y.z>/<score-platform>_<x.y.z>_<os_system>.tar.gz
  • Replace <score-platform> with the name of the Score implementation tool.
  • Replace <x.y.z> with the version number.
  • Replace <os_system> with your operating system.

For example, the following wget command downloads score-helm for macOS.

wget https://github.com/score-spec/score-helm/releases/download/0.2.0/score-helm_0.2.0_darwin_arm64.tar.gz

Results You should see something similar to the following output.

Saving to: `<score-platform>_<x.y.z>_<os_system>.tar.gz`

score-helm_0.2.0 100%[===================>]   2.85M  5.28MB/s    in 0.5s

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file. Update the following example to include the path to your file.

tar -xvzf ~/<your-path>/score-helm_<x.y.z>_<os_system>.tar -C /usr/local/bin/

Results You should see the following output.

x LICENSE
x README.md
x score-helm

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-helm --version

The command returns the following output.

score-helm <x.y.z>

Results You’ve successfully installed the Score implementation tool.

Step 1. Download the latest release

Download with the CLI wget command.

wget https://github.com/score-spec/<score-platform>/releases/download/<x.y.z>/<score-platform>_<x.y.z>_<os_system>.tar.gz
  • Replace <score-platform> with the name of the Score implementation tool.
  • Replace <x.y.z> with the version number.
  • Replace <os_system> with your operating system.

For example, the following wget command downloads score-humanitec for macOS.

wget https://github.com/score-spec/score-humanitec/releases/download/0.2.0/score-humanitec_0.2.0_darwin_arm64.tar.gz

Results You should see something similar to the following output.

Saving to: `score-humanitec_0.2.0_darwin_arm64.tar.gz`

score-humanitec_0.2.0 100%[===================>]   2.85M  5.28MB/s    in 0.5s

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file. Update the following example to include the path to your file.

tar -xvzf ~/<your-path>/<score-platform>_<x.y.z>_<os_system>.tar -C /usr/local/bin/

Results You should see the following output.

x LICENSE
x README.md
x score-humanitec

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-humanitec --version

The command returns the following output.

score-humanitec <x.y.z>

Results You’ve successfully installed the Score implementation tool.

Install the binary through the GitHub downloads page on macOS and Linux

Choose the Score Implementation you want to install.

Step 1. Download the latest release

  1. Open https://github.com/score-spec/score-compose/releases in your browser.

  2. Find the current release by scrolling down and looking for the green tag that reads Latest.

  3. Download the latest compressed Tar file for your operating system.

    1. The name will be something like score-compose_x.y_osx-amd64.tar.gz, where x.y is the release number, osx is the operating system.
  4. By default, the tarball will be saved to your ~/Downloads directory. If you choose to use a different location, you’ll need to change that in the following steps.

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file.

tar -xvzf ~/Downloads/score-compose_0.2.0_darwin_arm64.tar.gz -C /usr/local/bin/

Results You should see the following output.

x LICENSE
x README.md
x score-compose

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-compose --version

The command returns the following output.

score-compose x.y.z

Results You’ve successfully installed the Score implementation (CLI).

Step 1. Download the latest release

  1. Open https://github.com/score-spec/score-helm/releases in your browser.

  2. Find the current release by scrolling down and looking for the green tag that reads Latest.

  3. Download the latest compressed Tar file for your operating system.

    1. The name will be something like score-helm_x.y_osx-amd64.tar.gz, where x.y is the release number, osx is the operating system.
  4. By default, the tarball will be saved to your ~/Downloads directory. If you choose to use a different location, you’ll need to change that in the following steps.

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file.

tar -xvzf ~/Downloads/score-helm_0.2.0_darwin_arm64.tar.gz -C /usr/local/bin/

Results You should see the following output.

x LICENSE
x README.md
x score-helm

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-helm --version

The command returns the following output.

score-helm x.y.z

Results You’ve successfully installed the Score implementation (CLI).

Step 1. Download the latest release

  1. Open https://github.com/score-spec/score-humanitec/releases in your browser.

  2. Find the current release by scrolling down and looking for the green tag that reads Latest.

  3. Download the latest compressed Tar file for your operating system.

    1. The name will be something like score-humanitec_x.y_osx-amd64.tar.gz, where x.y is the release number, osx is the operating system.
  4. By default, the tarball will be saved to your ~/Downloads directory. If you choose to use a different location, you’ll need to change that in the following steps.

Step 2: Install into your local directory

In your terminal, enter the following to create the score-spec directory.

cd /usr/local/bin/
# create the directory if needed
mkdir -pv score-spec

Extract the compressed Tar file.

tar -xvzf ~/Downloads/score-humanitec_0.2.0_darwin_arm64.tar.gz -C /usr/local/bin/

Results You should see the following output.

x LICENSE
x README.md
x score-humanitec

Step 3: Export PATH

To export PATH, run the following command.

export PATH=$PATH:/usr/local/bin/

Future terminal sessions may require you add this path to your ~/.zshrc or ~/.bashrc file, if it isn’t there already.

Step 4: Verify installation

To verify installation, run the following command.

score-humanitec --version

The command returns the following output.

score-humanitec x.y.z

Results You’ve successfully installed the Score implementation (CLI).

Install the binary on Windows

Select a Score Implementation, decompress the zip file, and move the binary to your PATH.

Upgrade the Score implementation CLI

To upgrade the Score implementation (CLI), download the latest binary version and follow the installation instruction.