Formats and running it
An RPM mirror for dnf and yum
Switch on RPM mirror under Settings, Registries, Package types. Each RPM registry you add is one distro repository, like AlmaLinux 9 BaseOS, answered at /rpm/<its name>/.
A registry's address is the folder that holds repodata/, like https://repo.almalinux.org/almalinux/9/BaseOS/x86_64/os. Pick the advisory feed of its distro, and in whitelist mode add an RPM allow rule of *, then deny or kill what you do not want, since a distro has thousands of packages. Clients get a .repo file:
[company-baseos]
name=Company mirror of AlmaLinux 9 BaseOS
baseurl=https://packages.example.com/rpm/almalinux-9-baseos/
username=your-user-name
password=<your token>
gpgcheck=1
repo_gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-9
Two ways to hand out the index
By default the signed index goes out untouched, so clients keep repo_gpgcheck=1 and trust stays with the distro. Every package download is checked: the rules, the kill switch, holds, advisories and cooling off, then the package is checked against the checksum in the index, kept and scanned. The catch is that dnf still sees every version, so it can pick one that is then refused.
Filtered index hands out an index of only what the rules and the kill switch allow, so dnf never picks a refused version. The distro did not sign that index, so clients must set repo_gpgcheck=0. Package signatures are still checked with gpgcheck=1.
Either way, only the repodata and the packages its index lists are served, and every metadata file is checked against the checksum in repomd.xml.
What applies, and what does not
Rules, the kill switch, quarantine, cooling off (the index gives a publish time for each package), malware scanning (the OSV known malicious check included), license policy from the package header, requests and auto approve all apply. Advisories come from OSV, in the feed you pick for each mirror: AlmaLinux 8, 9 or 10, Rocky Linux 8, 9 or 10, or Red Hat.
Honest limits: rules take exact package names, with exact versions or comparators like >=3.0.7. Nothing is published here. Typosquat checks, provenance checks and the tree walk are not offered for RPM.
In short
- One mirror per distro repository, for dnf and yum
- Signed index untouched by default,
repo_gpgcheck=1kept - Filtered index option, with
repo_gpgcheck=0 - Every package checked, kept and scanned before it is served
- Advisories per mirror: AlmaLinux, Rocky Linux or Red Hat
In the documentation
- Set up dnf and yum Developer Guide
- When dnf cannot get a package Developer Guide
- RPM mirrors Administrator Guide
Goes well with
- APT mirror for Debian and Ubuntu Debian and Ubuntu archives for apt, every .deb checked and scanned, with an optional filtered index.
- Vulnerability monitoring OSV, CISA KEV and FIRST EPSS against everything allowed and cached. npm audit answered locally.
- Kill switch Take a package, a version range, one file hash or a whole advisory away from everyone, at once.
One container, about two minutes
A Linux box with Docker, or one without it, and a reverse proxy for TLS. The installer does the rest and it is safe to run twice. Free, MIT licensed, nothing to sign up for.