Mirroring Sabayon

From Sabayon Wiki
Jump to: navigation, search

If you are a mirror administrator or just somebody who would like to mirror Sabayon ISO images and packages, you have found the right page.


  • A Unix-based Operating System (directly or indirectly) connected to the Internet
  • At least 300GB of free disk space
  • At least 10Mbit/sec Internet connectivity, better if 100Mbit/sec or more
  • An HTTP Server of some sort
  • An rsync client

Setting up a mirroring script


# Local variables
RSYNC_ARGS="-a --partial --delete-during --force"

# Remote server variables


This is an example script that pulls the whole Sabayon stuff (ISO images, Entropy packages, Portage distfiles) from garr.it through the exposed "sabayonlinux" module. Do not use this script as-is, but rather customize it depending on your geographic location and Sabayon mirrors availability in your portion of the globe. You may find a list of rsync servers at the Sabayon download page. You may also want to only mirror parts of it, like ISO images or Entropy packages. This is possible by either playing with the exposed rsync modules or blacklisting the list of sync directories (see man rsync for more info). Unfortunately, every mirror has its own policies and we cannot assist you further. However, adding --list-only to RSYNC_ARGS makes the script print the currently available rsync modules for the given REMOTE_RSYNC_SERVER.

Setting up a cronjòb

We usually require mirror administrator to poll the REMOTE_RSYNC_SERVER every 2, 4, or 6 hours. The consumed bandwidth is the same, but higher frequency allows users to get new packages earlier. See man crontab for more info on how to setup a cron script.

Choosing the best rsync server

The Sabayon mirroring architecture is divided into 3 levels:

Level 0

the Sabayon official rsync server is available at rsync.sabayon.org and it's from where all the Level 1 mirrors are pulling. Given the restricted amount of bandwidth available, we cannot let everybody pull from this server, but if your geographic region is not covered by any good rsync server, you can mail us asking your server to be whitelisted.

Level 1

Big Companies and Big Universities that are pulling directly from our Level 0 rsync server. These Level 1 rsync servers are usually made available to the public for syncing through the rsync client.

Level 2

You (unless you are legally representing a University or Company).

Choosing the best rsync server is not a trivial task. Some of them may not be up to date and others may not offer the service for the country you are in. In order to determine if a mirror is alive, you can search for one of these files: entropy/TIMESTAMP, distfiles/TIMESTAMP, iso/TIMESTAMP and read the contained timestamp (unix epoch). If it's not older than one week, the probability that the mirror is alive is high. On the other hand, if you cannot find a good mirror, please mail us asking to sync directly from Level 0.

Registering your mirror

Once your mirror is up, you should mail us (website<-at->sabayon.org) with the following information:

  • Mirror name
  • Mirror organization
  • Mirror location
  • Mirror speed
  • Mirror administrator (email)
  • Mirror URL1
  • Mirror URL2
  • Mirror URL3

Letting us record the information into our database, our download page and push-only infra mailing list.