Installation
This guide demonstrates the installation steps of ORAS CLI on different platforms.
Homebrew
Install oras
using Homebrew:
brew install oras
Snap
Install oras
using Snap:
snap install oras --classic
Release artifacts
Install ORAS from the latest release artifacts:
Linux
If you want to install ORAS on an AMD64-based Linux machine, run the following command:
VERSION="1.2.0"
curl -LO "https://github.com/oras-project/oras/releases/download/v${VERSION}/oras_${VERSION}_linux_amd64.tar.gz"
mkdir -p oras-install/
tar -zxf oras_${VERSION}_*.tar.gz -C oras-install/
sudo mv oras-install/oras /usr/local/bin/
rm -rf oras_${VERSION}_*.tar.gz oras-install/
If you want to install ORAS on an ARM64-based Linux machine, you can download it from https://github.com/oras-project/oras/releases/download/v1.2.0/oras_1.2.0_linux_arm64.tar.gz
.
macOS
If you want to install ORAS on a Mac computer with Apple silicon, run the following command:
VERSION="1.2.0"
curl -LO "https://github.com/oras-project/oras/releases/download/v${VERSION}/oras_${VERSION}_darwin_arm64.tar.gz"
mkdir -p oras-install/
tar -zxf oras_${VERSION}_*.tar.gz -C oras-install/
sudo mv oras-install/oras /usr/local/bin/
rm -rf oras_${VERSION}_*.tar.gz oras-install/
If you want to install ORAS on an Intel-based Mac, you can download it from https://github.com/oras-project/oras/releases/download/v1.2.0/oras_1.2.0_darwin_amd64.tar.gz
.
Windows
- You can install ORAS CLI on Windows using WinGet (Windows Package Manager):
winget install oras --version 1.2.0
- Alternatively, you can install ORAS CLI using
.exe
installer. Add%USERPROFILE%\bin\
to yourPATH
environment variable so thatoras.exe
can be found.
set VERSION="1.2.0"
curl.exe -sLO "https://github.com/oras-project/oras/releases/download/v%VERSION%/oras_%VERSION%_windows_amd64.zip"
tar.exe -xvzf oras_%VERSION%_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:v1.2.0 help
The default WORKDIR in the image is /workspace
.
Nix
Nix is a tool that takes a unique approach to package management and system configuration.
The Nix Packages collection (Nixpkgs) is a set of over 80 000 packages for the Nix package manager.
oras also has a Nix package available in the Nixpkgs repository.
You can install nix CLI from here.
You can install oras using the following command:
nix-env -iA nixpkgs.oras
Verify
$ oras version
Version: 1.2.0
Go version: go1.22.3
Git commit: dcef719e208a9b226b15bc6512ad729a7dd93270
Git tree state: clean
You can check out our how-to guide if you would like to verify ORAS CLI Binaries.