# Install oras with Homebrew, apt, Nix, scoop, winget, zypper

OCI Registry As Storage. Version 1.3.2 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:oras
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install oras
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install oras
```

  Evidence: Debian stable package indexes: oras from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#oras
```

  Evidence: nixpkgs package indexes: pkgs/by-name/or/oras/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install oras
```

  Evidence: openSUSE Tumbleweed package metadata: oras from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install extras/oras
```

  Evidence: Scoop official bucket manifest trees: bucket/oras.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id ORASProject.ORAS -e
```

  Evidence: Windows Package Manager source index: ORASProject.ORAS from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:oras
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/oras>
- **Version:** 1.3.2
- **Source summary:** OCI Registry As Storage
- **Homepage:** <https://oras.land>
- **Repository:** <https://github.com/oras-project/oras>
- **Upstream docs:** <https://github.com/oras-project/oras#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/oras-project/oras/archive/refs/tags/v1.3.2.tar.gz>
- **Last updated:** 2026-06-15T10:20:22-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- oras (cli)
- oras (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.3.2
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/oras-project/oras
- Upstream latest detected: v1.3.2 (current)
## Project history and usage

ORAS, short for OCI Registry As Storage, is a command-line client and family of libraries for using OCI-compliant registries as a general artifact store rather than only a container-image store. The project describes ORAS as tooling for distributing OCI artifacts, managing artifact references, migrating content between registries, and working with OCI Image Layouts on disk.

### Project history

The ORAS project was established and open-sourced in December 2018. Its early significance came from a practical gap in the OCI ecosystem: registries had mature distribution, authentication, replication, and access-control machinery, but developers lacked standard client tooling for non-image artifacts such as Helm charts, policy bundles, signatures, and SBOMs.

ORAS joined the Cloud Native Computing Foundation at Sandbox maturity on July 13, 2021. The CNCF project page records the first commit on December 24, 2018 and identifies the project as multi-language OCI registry SDKs and a CLI.

### Adoption history

ORAS became important as the OCI ecosystem moved from storing images to storing supply-chain metadata and other deployable artifacts beside images. The ORAS project blog lists adopters and integrations including Amazon ECR, Amazon EKS Anywhere, Alibaba Cloud Service Mesh, Artifact Hub, Docker Hub, GitHub, Google Cloud, Helm, Singularity, Microsoft Azure Container Registry, Notary v2, KubeApps by VMware Tanzu, VMware Application Catalog, Emporous by Red Hat, soci-snapshotter by AWS, and Zot.

The project also fed back into OCI standardization. ORAS maintainers incubated artifact-reference work under the ORAS Artifact manifest project, and the ORAS blog describes that work being contributed to OCI Image and Distribution v1.1 release-candidate specifications in September 2022.

### How it is used

Operators use the `oras` CLI to push, pull, copy, attach, discover, tag, and inspect artifacts in registries that speak the OCI distribution protocol. That makes a registry useful for SBOMs, signatures, vulnerability reports, WASM modules, policy bundles, model files, and release payloads that need the same distribution and access-control model as images.

Tool authors use ORAS libraries, especially `oras-go`, to build registry-native clients. The ORAS Go documentation describes the v2 package as a registry client and content-replication library for applications that want to store arbitrary content in container registries.

### Why package nerds care

For package nerds, ORAS is a bridge between package distribution and container infrastructure. It turns the OCI registry from a Docker-image endpoint into a content-addressed package transport, which is why it appears in conversations about Helm, Notary, SBOMs, GitOps policy bundles, and registry-native release artifacts.

The `brew:oras` package is a compact CLI surface over a much larger ecosystem shift: using registry semantics, digests, media types, and artifact references as package-manager primitives.

### Timeline

- 2018-12: ORAS was established and open-sourced.
- 2021-07-13: ORAS was accepted into CNCF Sandbox.
- 2022-09: ORAS artifact-reference work was contributed toward OCI Image and Distribution v1.1 release-candidate specifications.
- 2024-06-18: ORAS v1.2.0 was announced with OCI Spec v1.1.0 support.

### Related projects

- ORAS sits beside the OCI image-spec and distribution-spec, and it is used by registry and supply-chain projects including Helm, Notary v2, Artifact Hub, Zot, and soci-snapshotter. Its language libraries include Go, Python, Rust, Java, .NET, and JavaScript-facing projects listed from the ORAS website.

### Sources

- <https://oras.land/>
- <https://oras.land/blog/oras-looking-back-at-2022-and-forward-to-2023/>
- <https://oras.land/docs/1.2/client_libraries/go/>
- <https://www.cncf.io/blog/2024/06/18/announcing-oras-v1-2-0-oci-spec-v1-1-0-support-formatted-output-and-more/>
- <https://www.cncf.io/projects/oras/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Credential files

- Unix: ~/.docker/config.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** oras
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - oras - 1.2.0-1+b9: normalized package name match | Debian stable package indexes: oras from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | OCI registry cli tool managing content like artifacts, images, packages | https://github.com/oras-project/oras
- Nix - oras: normalized package name match | nixpkgs package indexes: pkgs/by-name/or/oras/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - oras - 1.3.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oras from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | OCI registry client - manage content like artifacts, images, packages | https://github.com/oras-project/oras
- zypper - oras-bash-completion - 1.3.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oras-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for oras | https://github.com/oras-project/oras
- zypper - oras-fish-completion - 1.3.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oras-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for oras | https://github.com/oras-project/oras
- zypper - oras-zsh-completion - 1.3.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oras-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for oras | https://github.com/oras-project/oras
- Scoop - extras/oras: normalized package name match | Scoop official bucket manifest trees: bucket/oras.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- winget - ORASProject.ORAS: normalized package name match | Windows Package Manager source index: ORASProject.ORAS from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [skopeo](https://www.automicvault.com/pkg/brew/skopeo/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci, registry.
- [container](https://www.automicvault.com/pkg/brew/container/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci.
- [containerd](https://www.automicvault.com/pkg/brew/containerd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci.
- [dcp](https://www.automicvault.com/pkg/brew/dcp/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci.
- [rockcraft](https://www.automicvault.com/pkg/brew/rockcraft/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci.
- [umoci](https://www.automicvault.com/pkg/brew/umoci/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, oci.
- [amazon-ecs-cli](https://www.automicvault.com/pkg/brew/amazon-ecs-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [ansible-builder](https://www.automicvault.com/pkg/brew/ansible-builder/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.

## Combined YAML source

View the package source record on GitHub. [combined/oras.yml](https://github.com/automic-vault/db/blob/main/combined/oras.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
