NAME

apt-mirror - apt sources mirroring tool

SYNOPSIS

apt-mirror [configfile]

DESCRIPTION

A small and efficient tool that lets you mirror a part of or the whole Debian GNU/Linux distribution or any other apt sources.

Main features:
* It uses a config similar to APT's sources.list
* It's fully pool compliant
* It supports multithreaded downloading
* It supports multiple architectures at the same time
* It can automatically remove unneeded files
* It works well on an overloaded Internet connection
* It never produces an inconsistent mirror including while mirroring
* It works on all POSIX compliant systems with Perl and wget

COMMENTS

apt-mirror uses /etc/apt/mirror.list as a configuration file. By default it is tuned to official Debian or Ubuntu mirrors. Change it for your needs.

After you setup the configuration file you may run as root:

    # su - apt-mirror -c apt-mirror

Or uncomment the line in /etc/cron.d/apt-mirror to enable daily mirror updates.

FILES

/etc/apt/mirror.list
Main configuration file

/etc/cron.d/apt-mirror
Cron configuration template

/var/spool/apt-mirror/mirror
Mirror places here

/var/spool/apt-mirror/skel
Place for temporarily downloaded indexes

/var/spool/apt-mirror/var
Log files placed here. URLs and MD5 checksums also here.

CONFIGURATION EXAMPLES

The mirror.list configuration supports many options, the file is well commented explaining each option. Here are some sample mirror configuration lines showing the various supported ways:

Normal: deb http://example.com/debian stable main contrib non-free

Arch Specific: (many other architectures are supported) deb-powerpc http://example.com/debian stable main contrib non-free

HTTP and FTP Auth or non-standard port: deb http://user:pass@example.com:8080/debian stable main contrib non-free

HTTPS with sending Basic HTTP authentication information (plaintext username and password) for all requests: (this was default behaviour of Wget 1.10.2 and prior and is needed for some servers with new version of Wget) set auth_no_challenge 1 deb https://user:pass@example.com:443/debian stable main contrib non-free

HTTPS without checking certificate: set no_check_certificate 1 deb https://example.com:443/debian stable main contrib non-free

Source Mirroring: deb-src http://example.com/debian stable main contrib non-free

AUTHORS

Dmitry N. Hramtsov <hdn@nsu.ru> Brandon Holtsclaw <me@brandonholtsclaw.com>