---
name: "apt-mirror"
section: "1"
platform: "linux"
package: "apt-mirror"
version: "0.5.4-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/apt-mirror"
---

# apt-mirror(1)

apt sources mirroring tool

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