Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
APT-MIRROR(1)	       User Contributed Perl Documentation	   APT-MIRROR(1)

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 De-
     bian 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 up-
     dates.

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 com-
     mented 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@exam-
     ple.com:8080/debian stable main contrib non-free

     HTTPS with sending Basic HTTP authentication information (plaintext user-
     name 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>

perl v5.42.3			   2026-08-04			   APT-MIRROR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=apt-mirror&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help