Skip to main content

apt-mirror2

apt-mirror2 is the Python/asyncio reimplementation of the apt-mirror developed as drop-in replacement for the latest.
This project should be suitable as general apt-mirror replacement.

Requirements

Python 3.10 is the minimum supported version.
For additional dependencies look to the pyproject.yml and/or requirements.txt.

Installation

Docker

Docker image is available in the Docker Hub under aptmirror/apt-mirror2 repository. You can try it using

docker run -it --rm aptmirror/apt-mirror2 --help

PyPi

PyPi package is available with the name apt-mirror:

pip install apt-mirror
apt-mirror --help

Build from source with virtualenv

It's possible to use apt-mirror2 from a virtualenv:

# Let's work in the home folder
cd

# Create virtualenv
virtualenv ~/venv/apt-mirror2
source ~/venv/apt-mirror2/bin/activate

# Clone apt-mirror2 source code
git clone https://gitlab.com/apt-mirror2/apt-mirror2
cd apt-mirror2

# Install requirements
pip install -r requirements.txt

# Install apt-mirror2 into virtualenv
python setup.py install

apt-mirror --help

Usage

As the drop-in replacement for the apt-mirror this project supports same CLI syntax.

usage: apt-mirror [-h] [--version] [configfile]

positional arguments:
  configfile  Path to config file. Default /etc/apt/mirror.list

options:
  -h, --help  show this help message and exit
  --version   Show version

apt-mirror configuration compatibility

Most of apt-mirror configuration directives are supported.
As of now proxy for FTP repositories is not supported.

In addition there are some enhancements available:

  • Repositories without MD5 hashsums are correctly mirrored
  • Old index files are properly cleaned and don't produces errors in mirror processing
  • Standard source.list [ arch=arch1,arch2 ] can be used to specify multiple repository architectures for mirroring.
  • mirror_path URL PATH option may be used to specify PATH to use for saving mirror files instead of path that is generated from URL.
  • Additional configuration is loaded from the *.list files in the directory named same as configfile with the .d suffix. Eg /etc/apt/mirror.list.d/*.list.
  • Rate limit is enforced for overall download rate.
  • Non-zero exit code is returned if some of required files were not downloaded due to network or server errors or no repositories were configured.
  • HTTP user agent can be configured via user_agent configuration.
  • Configuration variables are exposed to postmirror_script.
  • by-hash list option can be used to control whether Acquire-By-Hash Release option should be respected or enforced.

License

GNU General Public License v3.0 or later

Metadata

Release files for apt-mirror 3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for apt-mirror 3
File Size Uploaded Provenance Actions
apt-mirror-3.tar.gz 63.2 kB Without provenance Details for apt-mirror-3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for apt-mirror 3
File Interpreter ABI Platform Actions
apt_mirror-3-py3-none-any.whl Python 3 none any Details for apt_mirror-3-py3-none-any.whl

Total release size: 113.2 kB

Release files / apt-mirror-3.tar.gz

Download URL apt-mirror-3.tar.gz
Size 63.2 kB
Tags Source
SHA-256 checksum
How to use checksums
fcaadfba3468460149dbd32426bad8e4f109e47a9aad478ab533b2ffef084eb2
BLAKE2b-256 checksum
How to use checksums
226afd4b229ec64f08265100d521f4cd00fe9d6748836b035fe066d427537016
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.10.13

Release files / apt_mirror-3-py3-none-any.whl

Download URL apt_mirror-3-py3-none-any.whl
Size 50.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b6907977192fe3ef5a58b1adceb28084cfc0b94ee156a8359ae206959a810c58
BLAKE2b-256 checksum
How to use checksums
54bc46117f3897ba5aeb2bf5086ef89b8f1533635265d93c25e3eece9f16f683
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.10.13

Security for apt-mirror 3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page