Open source · MIT licensed

The whole dependency tree, ready to cross the air gap.

Backpack collects every version of the packages you choose, and everything they depend on, into S3-compatible storage. Then it tells you exactly what's new, so each transfer carries only what changed.

  • .NET 8
  • RabbitMQ
  • S3 storage
  • Kubernetes or Compose

Features

A mirror you can trust to be complete

Backpack runs on the connected side of your network. It doesn't serve packages; it makes sure that everything your builds will ask for is already collected.

Exhaustive by default

Every version of every artifact you add, and recursively every version of everything it depends on. Filters narrow down what you ask for, never what it needs.

Built for the transfer

Every newly collected file is recorded in a daily delta folder, so an incremental transfer copies exactly what was added since the last one.

The upstream layout, kept

Files are stored under the host and path they came from, grouped by ecosystem: npm/registry.npmjs.org/express/express-4.21.2.tgz.

One service per ecosystem

Processors understand ecosystems, collectors speak protocols, and RabbitMQ connects them. Deploy only what you use, scale what's busy, add your own in any language.

Controlled intake

Sign in with your own OIDC provider. Require an administrator's approval per ecosystem before anything is collected, and give automation API keys.

Runs on your infrastructure

Kubernetes with the Helm chart or Docker Compose, MinIO, SeaweedFS, Ceph or AWS S3, and OpenTelemetry traces and metrics.

How it works

From one request to a complete mirror

  1. Add an artifact

    Request express, Newtonsoft.Json or docker.io/library/nginx in the web interface or through the REST API.

  2. Resolve the tree

    The ecosystem's processor lists every version, its files and its direct dependencies. The gateway follows each dependency in turn until the tree is complete.

  3. Collect

    Collectors download what isn't stored yet, write it to your bucket and record it in the day's delta. Scheduled re-tracking picks up new releases.

  4. Carry it across

    Copy the delta folders since your last transfer to the isolated network, and load them into the registries and proxies you already run there.

delta/npm/2026_10_31/ · added today
  • registry.npmjs.org/express/express-4.21.2.tgz
  • registry.npmjs.org/body-parser/body-parser-1.20.3.tgz
  • registry.npmjs.org/cookie/cookie-0.7.1.tgz
  • registry.npmjs.org/send/send-0.19.0.tgz
  • registry.npmjs.org/qs/qs-6.13.0.tgz
Each entry points at the stored file, e.g. npm/registry.npmjs.org/express/express-4.21.2.tgz.

Ecosystems

The registries your builds depend on

Each ecosystem is a small service you deploy when you need it.

  • npmNode.js packages
  • NuGet.NET packages
  • PyPIPython packages
  • Container imagesInto a registry, or as tarballs
  • HelmCharts and the images they use
  • TerraformProviders
  • Hugging FaceModels
  • GitHub ReleasesRelease assets
  • JetBrainsIDEs and plugins
  • RancherRelease image lists
  • GitWhole repositories, as bundles
  • Your own.NET template, or JSON over RabbitMQ

Deploy

Get started

Backpack needs RabbitMQ, MongoDB, Redis, S3-compatible storage and an OIDC provider.

Kubernetes

Install with the Helm chart and point it at your RabbitMQ, MongoDB, Redis, storage and OIDC provider. Add the processors and collectors you need to its values.

Every value is documented in the chart README.

Shell
helm repo add backpack https://linus-berg.github.io/helm-charts/
helm show values backpack/backpack > my-values.yaml
# set oidc, rabbitmq, mongo, redis and s3
helm install backpack backpack/backpack \
  -n backpack --create-namespace -f my-values.yaml

Docker Compose

Try a complete single-machine stack, infrastructure and sign-in included, with npm ready to go.

See the example README for signing in and adding ecosystems.

Shell
git clone https://github.com/linus-berg/backpack.git
cd backpack/example
# first add "127.0.0.1 keycloak" to /etc/hosts
docker compose up -d
# then open http://localhost:3000