+1
Daily
301
stars
189
forks
9
watchers
1,200
prs
558
issues
49
releases
README
ORAS Go library oras-go is a Go library for managing OCI artifacts, compliant with the OCI Image Format Specification and the OCI Distribution Specification. It provides unified APIs for pushing, pulling, and managing artifacts across OCI-compliant registries, local file systems, and in-memory stores. [!Note] The main and v2 branches follow Go's Security Policy and support the two latest versions of Go (currently 1.26 and 1.27). Getting Started Concepts Gain insights into the fundamental concepts: - Modeling Artifacts - Targets and Content Stores Quickstart Follow the step-by-step tutorial to use oras-go v3: - Quickstart: Managing OCI Artifacts with oras-go v3 Examples Check out sample code for common use cases of oras-go v3: - Artifact copying - Registry operations - Repository operations - Authentication - Credentials management Find more API examples at pkg.go.dev. Versioning This project follows Semantic Versioning (MAJOR.MINOR.PATCH), with MAJOR for breaking changes, MINOR for backward-compatible features, and PATCH for backward-compatible fixes. Branches - To migrate from v2 to v3, see MIGRATION_GUIDE.md. - To migrate from v1 to v2, see the v2 branch migration guide. main (v3 development) The main branch is under active development for v3 and may contain breaking changes. Not recommended for production use. v2 (stable) The v2 branch contains the latest stable release and is recommended for production use. New features and bug fixes from main will be backported to v2 if applicable. v1 (end-of-life) The v1 branch has reached end-of-life and is no longer maintained. Community - Code of Conduct: CODE_OF_CONDUCT.md - Security Policy: SECURITY.md - Reviewing Guide: Reviewing Guide - Slack: oras channel on CNCF Slack
Top issues
Discussions
#1106Any way to check a repository similar to the registry ping?1 comments · 2026-02-24#1088Built-in compression support for layer push/fetch1 comments · 2025-12-28#911panic: invalid OCI Image Index: trailing data1 comments · 2025-03-04#703Digest without timestamp1 comments · 2024-02-06#586Add more information in Warning0 comments · 2023-08-01#476How to authenticate with AAD access token1 comments · 2023-04-06#413SDK for `oras login`3 comments · 2023-01-16#277Support disabling digest validation for manifestStore.Fetch in remote package0 comments · 2022-08-23
Latest release
v3.0.0 v3.0.0 2026-11-01ORAS Go v3.0.0 is the first stable release of the v3 line. It adds a configuration layer compatible with containers/image, a client builder, registry mirrors, policy and signature verification, content verification, and new push modes. It also reorganizes remote-registry configuration so that a registry owns the settings its repositories share. The module path has changed. v3 is published as github.com/oras-project/oras-go/v3: diff -oras.land/oras-go/v2 +github.com/oras-project/oras-go/v3 sh go get github.com/oras-project/oras-go/[email protected] go mod tidy The v2 and v3 module paths are disti