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 2

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 2
File Size Uploaded Provenance Actions
apt-mirror-2.tar.gz 61.0 kB Without provenance Details for apt-mirror-2.tar.gz

Built distribution (wheel)

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

Total release size: 109.2 kB

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

Download URL apt-mirror-2.tar.gz
Size 61.0 kB
Tags Source
SHA-256 checksum
How to use checksums
03e57f22584db4cd2d99dceee90b2ae4a9a3b383dd1d4de67e9560c14ad1713d
BLAKE2b-256 checksum
How to use checksums
bcdb097834ee883e51ba99aca2235ab6bf184220e51dad6ac57b7af04298608e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.13

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

Download URL apt_mirror-2-py3-none-any.whl
Size 48.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
837eaa27a39c2a38c29204ce14b4d1db08c96ca9febe822f65a07bc8dc51b6fb
BLAKE2b-256 checksum
How to use checksums
b4b24d1e96a94146da9709e4f34873207c77c5919b5c7cafcc200873ce9cb7b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.13

Security for apt-mirror 2

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