This wiki was updated to MediaWiki 1.37. If you notice any issues, please report them to admin[at]


Jump to: navigation, search


Download redirector and Metalink generator

Vendor: openSUSE
Developer: Andrii Nikitin, Elisei Roca
License: GPL-2


MirrorCache is an open source framework to run a content delivery network using mirror servers. It comes with features that MirrorBrain is lacking.


  • Open source
  • Job Queue, including WebUI to manage jobs (e.g. mirror scans)
  • Tracks mirrors capability to serve http / https and ipv4 / ipv6 and route requests accordingly
  • WebUI for managing mirrors
  • Metalink generation


Setting up MirrorCache for your machine

For early adapters, Use steps below if you wish to batch replace baseurl used by zypper repositories.

First, choose one of the MirrorCache instances that are closely to you: has European mirrors only has North America mirrors has Oceania mirrors has Japan mirrors has all the rest mirrors and may redirect requests to a corresponding regional instance

Preview current baseurl used in repo files with shell command:

   grep baseurl /etc/zypp/repos.d/*.repo


   zypper lr -u

The command below demonstrates how to replace '' with '', adjust it for your needs:

   sudo sed -i "s,,,g" /etc/zypp/repos.d/*.repo

After that, you should already be set. Just remember that all new traffic is now not only going over an secured HTTPS connection, but is also using mirrors that are as close as possible to your home.

If in doubt, one can check region as it sees the instance by visiting


In most of cases good start is to review /var/log/zypper.log and check output of curl -IL for problem url, e.g.

   curl -IL

How to get help

See also

External links