Skip to content

docs: restore snap installation instructions for v1.3#557

Merged
FeynmanZhou merged 1 commit intooras-project:mainfrom
TerryHowe:fix/restore-snap-install-docs
Apr 15, 2026
Merged

docs: restore snap installation instructions for v1.3#557
FeynmanZhou merged 1 commit intooras-project:mainfrom
TerryHowe:fix/restore-snap-install-docs

Conversation

@TerryHowe
Copy link
Copy Markdown
Member

Summary

The snap installation section was removed from the v1.3 docs, which prompted issue oras-project/oras#1965. Now that the snap release workflow is active and publishing to the Snap Store (as of oras-project/oras#2011), restore the installation instructions.

Changes

  • Adds a Snap section to versioned_docs/version-1.3/installation.mdx with snap install oras --classic
  • Includes a note explaining that --classic is required because ORAS uses classic confinement to access files outside the snap sandbox
  • Adds Snap to the list of package managers mentioned in the verification note

Why --classic is required

ORAS is a CLI tool that reads and writes files at arbitrary paths provided by the user. Strict snap confinement would prevent this, so classic confinement is intentional and the --classic flag is unavoidable.

Fixes oras-project/oras#1965

The snap installation section was removed from the v1.3 docs. Now that
the snap release workflow is active and publishing to the Snap Store,
restore the installation instructions with the required --classic flag.

ORAS uses classic confinement to access files outside the snap sandbox,
so users need to pass --classic when installing.

Fixes oras-project/oras#1965

Signed-off-by: Terry Howe <terrylhowe@gmail.com>
Copy link
Copy Markdown
Member

@FeynmanZhou FeynmanZhou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks @TerryHowe

@FeynmanZhou FeynmanZhou merged commit f48844a into oras-project:main Apr 15, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

snap install problem

2 participants