Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 507 Commits
.github		.github
content		content
docs		docs
errdef		errdef
internal		internal
registry		registry
.gitignore		.gitignore
CODEOWNERS		CODEOWNERS
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE		LICENSE
MIGRATION_GUIDE.md		MIGRATION_GUIDE.md
Makefile		Makefile
OWNERS.md		OWNERS.md
README.md		README.md
SECURITY.md		SECURITY.md
content.go		content.go
content_test.go		content_test.go
copy.go		copy.go
copy_test.go		copy_test.go
copyerror.go		copyerror.go
copyerror_test.go		copyerror_test.go
example_copy_test.go		example_copy_test.go
example_copyerror_test.go		example_copyerror_test.go
example_pack_test.go		example_pack_test.go
example_test.go		example_test.go
extendedcopy.go		extendedcopy.go
extendedcopy_test.go		extendedcopy_test.go
go.mod		go.mod
go.sum		go.sum
pack.go		pack.go
pack_test.go		pack_test.go
target.go		target.go

Repository files navigation

ORAS Go library

oras-go is a Go library for managing OCI artifacts, compliant with theOCI Image Format Specification and theOCI Distribution Specification. It provides unified APIs for pushing, pulling, and managing artifacts across OCI-compliant registries, local file systems, and in-memory stores.

Note

Themain andv2 branches followGo's Security Policy and support the two latest versions of Go (currently1.24 and1.25).

Getting Started

Concepts

Gain insights into the fundamental concepts:

Quickstart

Follow the step-by-step tutorial to useoras-go v2:

Quickstart: Managing OCI Artifacts withoras-go v2

Examples

Check out sample code for common use cases:

Find more API examples atpkg.go.dev.

Versioning

This project followsSemantic Versioning (MAJOR.MINOR.PATCH), withMAJOR for breaking changes,MINOR for backward-compatible features, andPATCH for backward-compatible fixes.