Installation

This guide demonstrates the installation steps of ORAS CLI on different platforms.

Homebrew

Install oras using Homebrew:

brew install oras

Release artifacts

Install from the latest release artifacts:

Linux

curl -LO https://github.com/oras-project/oras/releases/download/v0.16.0/oras_0.16.0_linux_amd64.tar.gz
mkdir -p oras-install/
tar -zxf oras_0.16.0_*.tar.gz -C oras-install/
mv oras-install/oras /usr/local/bin/
rm -rf oras_0.16.0_*.tar.gz oras-install/

macOS

curl -LO https://github.com/oras-project/oras/releases/download/v0.16.0/oras_0.16.0_darwin_amd64.tar.gz
mkdir -p oras-install/
tar -zxf oras_0.16.0_*.tar.gz -C oras-install/
mv oras-install/oras /usr/local/bin/
rm -rf oras_0.16.0_*.tar.gz oras-install/

Windows

Add %USERPROFILE%\bin\ to your PATH environment variable so that oras.exe can be found.

curl.exe -sLO  https://github.com/oras-project/oras/releases/download/v0.16.0/oras_0.16.0_windows_amd64.zip
tar.exe -xvzf oras_0.16.0_windows_amd64.zip
mkdir -p %USERPROFILE%\bin\
copy oras.exe %USERPROFILE%\bin\
set PATH=%USERPROFILE%\bin\;%PATH%

Docker Image

A public Docker image containing the CLI is available on GitHub Container Registry:

docker run -it --rm -v $(pwd):/workspace ghcr.io/oras-project/oras:v0.16.0 help

Note: the default WORKDIR in the image is /workspace.

Verify

$ oras version
Version:        0.16.0
Go version:     go1.19
Git commit:     d606fed4be252fd6162f63548e024451c31f3864
Git tree state: clean

---

Last update: November 7, 2022