Repositories & Caching

Model upstream mirrors and pull-through caching so installs are fast, reproducible, and survive an upstream outage.

How to Manage Repositories and Upstream Mirrors Enable and disable repositories, configure anonymous access, browse cached packages, view per-repository traffic, and set up client connection guides. Beginner 15 minutes DevOps / Platform Engineers How to Manage Cache and Optimize Build Performance Monitor cache hit ratios, understand the blob storage architecture, purge cached packages, and optimize cache performance for faster builds. Intermediate 20 minutes DevOps / Platform Engineers How to Point npm at Chainsaw Configure npm (and Bun) to install through your Chainsaw proxy via .npmrc, global config, and authentication. Beginner 15 minutes Developers / DevOps Engineers How to Point pip / PyPI at Chainsaw Configure pip to install through your Chainsaw proxy via pip.conf, the PIP_INDEX_URL environment variable, and per-command flags. Beginner 15 minutes Developers / DevOps Engineers How to Point Maven at Chainsaw Mirror Maven Central through your Chainsaw proxy by configuring settings.xml with a mirror and server credentials. Beginner 15 minutes Developers / DevOps Engineers How to Point RubyGems at Chainsaw Configure Bundler and your Gemfile to install Ruby gems through your Chainsaw proxy. Beginner 15 minutes Developers / DevOps Engineers How to Point Go Modules at Chainsaw Configure the Go module proxy (GOPROXY) to fetch modules through your Chainsaw instance. Beginner 15 minutes Developers / DevOps Engineers How to Point NuGet at Chainsaw Configure the NuGet/.NET client to restore packages through your Chainsaw proxy via nuget.config or the dotnet CLI. Beginner 15 minutes Developers / DevOps Engineers How to Point Cargo at Chainsaw Redirect crates.io through your Chainsaw proxy with a Cargo registry replacement, and use the native credential provider on cargo 1.74+. Beginner 15 minutes Developers / DevOps Engineers How to Point Composer at Chainsaw Configure Composer (PHP) to resolve packages through your Chainsaw Packagist mirror via composer.json. Beginner 15 minutes Developers / DevOps Engineers How to Point Docker / OCI at Chainsaw Pull and push container images through your Chainsaw proxy using the Docker registry v2 API and org-scoped repository paths. Beginner 15 minutes Developers / DevOps Engineers How to Point APT at Chainsaw Configure APT on Debian/Ubuntu to fetch packages through your Chainsaw proxy via sources.list and auth.conf. Beginner 15 minutes Developers / DevOps Engineers How to Point RPM (Yum / DNF) at Chainsaw Configure Yum/DNF on RHEL/CentOS/Fedora to fetch RPM packages through your Chainsaw proxy via a .repo file. Beginner 15 minutes Developers / DevOps Engineers How to Point Hugging Face at Chainsaw Route Hugging Face model and dataset downloads through your Chainsaw proxy with the HF_ENDPOINT environment variable. Beginner 15 minutes Developers / DevOps Engineers

Chainsaw is a pull-through cache as well as a firewall. Every repository you define maps an ecosystem (npm, PyPI, Maven, …) to one or more upstream mirrors and caches the artifacts it fetches on your network. That gives you faster installs, reproducible builds, and continuity when an upstream registry is slow or down — all while every fetch still passes through policy.

Mental model. A repository is the ecosystem endpoint your package manager points at. Its upstream mirrors are where Chainsaw fetches a miss from. The cache is the local copy it keeps. Get this model right and the rest of the product follows.

Repository and cache management come first; the per-ecosystem cards below give focused, copy-paste pages for pointing a single client at Chainsaw. For the combined reference covering every ecosystem (plus Gradle, CocoaPods, Swift PM, and sbt), see How to Configure Your Package Manager to Use Chainsaw.

Where to next

Repositories are configured during install — see Getting Started if you have not deployed the proxy yet. To watch cache and traffic behavior in production, see Monitoring & Compliance.