Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
March 14, 2023 10:29
September 5, 2023 22:11

ORAS Go library


Project status


The ORAS Go library follows Semantic Versioning, where breaking changes are reserved for MAJOR releases, and MINOR and PATCH releases must be 100% backwards compatible.

v2: stable

Build Status codecov Go Report Card Go Reference

The version 2 is actively developed in the main branch with all new features.


The main branch follows Go's Security Policy and supports the two latest versions of Go (currently 1.20 and 1.21).

Examples for common use cases can be found below:

If you are seeking latest changes, you should use the main branch (or a specific commit hash) over a tagged version when including the ORAS Go library in your project's go.mod. The Go Reference for the main branch is available here.

To migrate from v1 to v2, see

v1: stable

Build Status Go Report Card Go Reference

As there are various stable projects depending on the ORAS Go library v1, the v1 branch is maintained for API stability, dependency updates, and security patches. All v1.* releases are based upon this branch.

Since v1 is in a maintenance state, you are highly encouraged to use releases with major version 2 for new features.


Code of Conduct

This project has adopted the CNCF Code of Conduct. See for further details.