umirr: micro mirror service

Umirr is an application for generating a geographically-relative list of mirrors for Fedora or RHEL based distributions. The output is designed to be parsed by yum, configured via the mirrorlist parameter in yum repo files. It is designed to be as simple as possible.

Why create a new mirror service?

I needed to deploy a mirrorlist solution, but I didn't like any of the existing options. They all seemed overly complicated for my needs. The only thing I wanted was an API cable of returning the mirrorlist text. I didn't care about a pretty web portal or managing users. I also didn't think the amount of data justified using a database. All of umirr's configuration and data are read from simple yaml files.

How does it work?

Umirr is a python WSGI application. To keep things as lean as possible, it doesn't lookup geoip information itself. Instead, it relies on HTTP headers for generating results. Typically this mean running it behind a webserver capable of looking up the geoip information for request source IPs.

Required headers:

• X-Forwarded-For-Latitude
• X-Forwarded-For-Longitude

Optional headers:

• X-Forwarded-For
• X-Forwarded-For-City
• X-Forwarded-For-Region
• X-Forwarded-For-Country

What are the requirements?

• falcon
• PyYAML
• six
• python WSGI HTTP server (gunicorn recommended)
• web server capable of looking up geoip information of request source IPs (nginx recommended)

How do I install this?

Take a look at INSTALL.md.