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.
| Guide | Covers |
|---|---|
| Usage | Client configuration, environment variables, volumes, logs and maintenance |
| Docker | Installation, Docker run, Compose, and building from source |
| Kubernetes | Pod and Service manifests |
| 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 |
- Fork the repository
- Submit Pull Requests / Merge Requests
- File issues with Docker version, run/compose command, and environment details
- 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
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.
Apt-Cacher NG is distributed under the BSD-4-Clause license.