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
       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>

perl v5.42.0			  2025-11-03			 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.0>

home | help