Install the Score implementation (CLI)

This section covers how to install the Score implementation (CLI).

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

Choose one of the following methods to continue.

Install the binary 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/cli@latest

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

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

Install using a manual method

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

Install the binary with curl on macOS

Choose Score implementation tool you want to install.

Step 1. Download the latest release

curl -L0 "https://github.com/score-spec/score-compose/releases/download/0.1.0/score-compose_0.1.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.1.0/score-helm_0.1.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.1.0/score-humanitec_0.1.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 Score implementation tool 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.1.0/score-compose_0.1.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.1.0/score-helm_0.1.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.1.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.1.0/score-humanitec_0.1.0_darwin_arm64.tar.gz

Results You should see something similar to the following output.

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

score-humanitec_0.1.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 Score implementation tool 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.1.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.1.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.1.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 (CLI), uncompress 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.