Lazy mirror for RPM packages

This is a lazy mirror for RPM packages running on Node.js. You can point your Fedora/CentOS boxes to a machine running the lazy package mirror to speed up the downloading of RPM packges. The lazy package mirror will download the packages once from the Internet and it will cache them for the Linux boxes in your local network. In this way, packages will have to be downloaded only once from the Internet and you don't have to maintain a complete mirror of your distribution's package repositories.

Still work in progress, but it is usable already.

The lazy package mirror works together with the DNF plugin for detecting local mirrors.

TODO

• Add admin web interface
• ...

Installation

We assume that the lazy package mirror is installed on machined named 'fileserver'.

1. Ensure that node.js and npm are installed, e.g. on Fedora:

   # dnf install nodejs npm
   

2. Create a system user 'lpm' with home directory '/opt/lazy-package-mirror/':

   # mkdir /opt/lazy-package-mirror
   # useradd --home-dir=/opt/lazy-package-mirror/ --system --user-group lpm
   # chown lpm:lpm /opt/lazy-package-mirror/
   

3. Create a cache directory, e.g. /var/cache/lazy-package-mirror/:

   # mkdir /var/cache/lazy-package-mirror/
   # chown lpm:lpm /var/cache/lazy-package-mirror/
   

4. Create directories for the configuration files:

   # mkdir /etc/lazy-package-mirror/
   # mkdir /etc/lazy-package-mirror/distros.d/
   # chown lpm:lpm -R /etc/lazy-package-mirror/
   

5. Clone this git repository

   # cd /opt
   # sudo -H -u lpm git clone https://github.com/michel-ludwig/lazy-package-mirror.git
   

6. In '/opt/lazy-package-mirror/' run 'npm install'

   # cd /opt/lazy-package-mirror/
   # sudo -H -u lpm npm install
   

7. Create a file named 'lazy-package-mirror.conf' under '/etc/lazy-package-mirror/' following the example below:

   listenPort = 7000
   cacheDir = /var/cache/lazy-package-mirror/
   hostName = fileserver
   logRequests = false
   

8. For every distribution for which you want to cache packages, create an appropriate configuration file named '.repos' under '/etc/lazy-package-mirror/distros.d/', for example for Fedora under '/etc/lazy-package-mirror/distros.d/fedora.repos':

   [repo:fedora]
   downloadURL = http://ftp-stud.hs-esslingen.de/Mirrors/fedora.redhat.com/linux/releases/$releasever/Everything/$basearch/os/
   
   [repo:updates]
   downloadURL = http://ftp-stud.hs-esslingen.de/Mirrors/fedora.redhat.com/linux/updates/$releasever/Everything/$basearch/
   

9. Set the owner and the permissions of the configuration files:

   # chown lpm:lpm -R /etc/lazy-package-mirror/
   # chmod 600 /etc/lazy-package-mirror/lazy-package-mirror.conf
   # chmod 600 /etc/lazy-package-mirror/distros.d/fedora.repos
   

10. Run the lazy mirror with 'node lazy-package-mirror' in '/opt/lazy-package-mirror/'

    # cd /opt/lazy-package-mirror
    # sudo -H -u lpm node lazy-package-mirror
    

11. Alternatively, to run the lazy package mirror with systemd, even during boot up:

    # cp /opt/lazy-package-mirror/systemd/lazy-package-mirror.service /etc/systemd/system/
    # systemctl start lazy-package-mirror
    # systemctl enable lazy-package-mirror