hlhd/apt-cacher-ng
Caching proxy for Debian and Ubuntu package downloads.
2.3K
hlhd/apt-cacher-ng repository overview
📦 apt-cacher-ng
A caching proxy for Debian-based package downloads (e.g., APT). This image is ideal for improving speed and reducing bandwidth in CI pipelines or homelab networks that frequently install packages from Debian, Ubuntu, or other APT-based distributions. Includes built-in logging support for monitoring usage and troubleshooting caching behavior.
Features
| Log Streaming | Functional container log streaming via tail -F to stdout |
| Runtime Overrides | Configure PassThroughPattern, concurrency, and timeouts at runtime |
| Secure Volumes | Init-based ownership management for cache and log directories |
| Health Checks | Built-in HTTP health check against the report page |
| Tini Init | Proper signal handling and zombie reaping via tini |
Documentation
| Topic | |
|---|---|
| Usage | Running the image, client configuration, and maintenance |
| Docker | docker-compose.yaml |
| Kubernetes | pod.yaml · service.yaml |
Installation
Pull the image from Docker Hub or build it yourself:
docker pull docker.io/hlhd/apt-cacher-ng:latest
git clone https://github.com/HomeLabHD/apt-cacher-ng
cd apt-cacher-ng
docker build -t hlhd/apt-cacher-ng .
Contributing
- Fork the repository
- Submit Pull Requests / Merge Requests
- File issues with Docker version, run/compose command, and environment details
Credits
- Based on Apt-Cacher NG by Eduard Bloch, the caching proxy for Linux package archives — source · BSD-4-Clause
- Inspired by sameersbn/docker-apt-cacher-ng — I struggled to find an image with working logs, so I made one
Disclaimer
The Software provided hereunder ("Software") is licensed "as-is," without warranties of any kind—express, implied, or telepathically transmitted. The Softwarer (yes, that's totally a word now) makes no promises about functionality, performance, compatibility, security, or availability—and absolutely no warranty of any sort. The developer shall not be held responsible, even if the software is clearly the reason your dog ran off to join a circus, or your mom scored five tickets to Hawaii but you missed out because you were knee-deep in a gaming bender.
If using this caching proxy leads you down a rabbit hole of obsessive network optimizations, breaks your fragile grasp of version pinning, or causes an uprising among your offline-first containers—sorry, still not liable. Also not liable if your repo mirror syncs so fast it rips a hole in the space-time continuum. The developer likewise claims no credit for anything that actually goes right either. Any positive experiences are owed entirely to the brilliant folks behind the original tools, their forks, and the unstoppable force that is the Open Source community.
It's never been a better time to be a PC user—just don't blame me when it inevitably eats your weekend.
License
Apt-Cacher NG is distributed under the BSD-4-Clause license.
Tag summary
Content type
Image
Digest
sha256:b574f1e3a…
Size
34 MB
Last updated
about 1 month ago
docker pull hlhd/apt-cacher-ng