Ravenstash key concepts
Ravenstash organizes private content like this:
account or organization → namespace → repository → registry type ├─ package → version → file └─ OCI repository → tag/digest → manifest/blob/referrer| Term | Meaning |
|---|---|
| User | One signed-in person. |
| Owner | The personal account or organization that owns a repository and its automation tokens. |
| Organization | A group of users with shared repositories and tokens. Membership does not replace a user’s personal account. |
| Namespace | An owner-level repository namespace and organization-member access boundary. Every owner has a default namespace. |
| Repository | A private package and artifact space inside a namespace. It can support one or more registry types. |
| Registry type | PyPI, npm, Maven, Container, or Helm support within a repository. Each keeps its familiar package format, URL, and tools. |
| Package / version / file | A PyPI, npm, or Maven package groups versions; a version contains one or more package files. |
| OCI repository / tag / digest | A Container or Helm OCI repository groups manifests and blobs. Tags are mutable selectors; digests are immutable identities. |
| API token | An automation credential used by rvs in CI and release jobs. It can access repositories owned by the same owner. |
| Private mirror | A private read-only mirror of a public or authenticated package source. Use it directly or connect it to a private repository. |
| Package storage | Where private packages and eligible custom-mirror files are stored: managed North America, European Union - GDPR Compliance, or reusable customer-owned storage. Storage location is separate from worldwide package delivery. |
How registry kinds fit into a repository
Section titled “How registry kinds fit into a repository”All enabled registry types share the repository owner, namespace, name, and storage choice. Each keeps its familiar package format and generated URL. The generated stable URL continues to identify the same repository when display names change.
For example:
https://pypi.rvsta.sh/in_wsabc123/r_repo1234/simple/https://npm.rvsta.sh/in_wsabc123/r_repo1234/https://maven.rvsta.sh/in_wsabc123/r_repo1234/oci.rvsta.sh/platform/runtime-images/acme/api:1.0.0See Multiple ecosystems in one repository and Organizations for details.