Skip to content

Releases: felix-homelab/apt-cache-proxy

v1.0.1

Choose a tag to compare

@felix-homelab felix-homelab released this 12 Jan 18:41

v1.0.1 - Docker Optimization & Pipeline Polish

We are happy to push v1.0.1, a focused update aimed at streamlining the Docker experience and optimizing our release pipelines. This version creates a stricter, more reliable container environment and cleans up legacy configuration methods.

🐳 Docker Enhancements

  • Enforced Persistence: We now strictly enforce fixed paths for storage and the database when running inside Docker. This ensures volume mounting behavior is predictable and your cache data remains safe.
  • Optimized Images: Added a .dockerignore file to exclude unnecessary files from the build context, resulting in cleaner and more efficient image builds.

⚙️ CI/CD & Operations

  • Release-Focused Builds: Our CI pipeline has been updated to strictly build and publish Docker images only on official release tags, preventing unnecessary noise from development branches.
  • Git Cleanup: Tidied up .gitignore to keep the repository clean and organized.

📄 Documentation Changes

  • Container First: We have removed the legacy systemd service files and instructions. We are doubling down on a container-first approach to ensure the most consistent experience across all environments.

Full Changelog: v1.0.0...v1.0.1

v1.0.0 - Initial Release

Choose a tag to compare

@felix-homelab felix-homelab released this 12 Jan 18:05

We are excited to announce the first stable release of APT Cache Proxy! This release brings a modern, lightweight, and feature-rich caching solution for APT (and other package managers) to help you save bandwidth and speed up your local network.

🚀 Key Features

  • Dynamic Caching & Discovery: Automatically learns and caches packages from new upstream mirrors on demand.
  • Multi-Distro Support: Out-of-the-box support for Debian, Ubuntu, Fedora, CentOS, Rocky, AlmaLinux, OpenSUSE, Kali, Arch, Alpine, and more.
  • Web Dashboard: Real-time monitoring of cache hits, bandwidth usage, and storage distribution.
  • Admin Panel: Secure interface to manage mirrors, blacklist packages, manually trigger downloads, and configure retention policies.
  • HTTPS Tunneling: Transparent support for repositories that cannot be cached (e.g., official Docker/NVIDIA repos).
  • Persistent Statistics: Usage data is saved to a SQLite database and persists across restarts.
  • Automatic Cleanup: Background tasks automatically remove old cache files based on configurable retention periods.

🐳 Docker Support

This release includes full Docker support for easy deployment:

  • Containerized: Official Docker image available via GHCR.
  • Compose Ready: Includes docker-compose.yml for local dev and docker-compose.prod.yml for production.
  • CI/CD: Automated workflows to build and publish images on release.