Docs
Upstream cache
Configure upstream read-through for private repositories and understand Ravenstash remote-cache behavior.
Updated 2026-06-24
Ravenstash private repositories can configure upstream read-through for supported PyPI, npm, and Maven misses.
How it works
- A package client requests a package from a private Ravenstash repository.
- Ravenstash checks the private repository first.
- If there is an upstream entry and the miss is allowed by policy, Ravenstash resolves the official upstream.
- Cold artifact file requests enqueue Ravenstash-managed cache population.
- Warm artifacts are served from Ravenstash remote storage through the private repository access flow.
Minimum age
Repositories send a minimum-age value for the attached upstream. Maven uses Maven Central Last-Modified data when available. PyPI and npm enqueue bounded recent-version ingest on metadata misses.
Remote-cache visibility
The app exposes remote repository and remote package pages for cache contents, attached private repositories, download counts, bandwidth usage, and cache-removal actions.
Current status
This is not a public anonymous mirror and not bulk preseeding. It is private-repository upstream fallback with bounded cache population.
