Forge Home


Installs, configures, and manages apt-cacher.


7,454 latest version

4.0 quality score

Version information

  • 1.0.0 (latest)
released Apr 21st 2016
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 3.0.0 < 5.0.0
  • Debian

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'alexklein-apt_cacher', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add alexklein-apt_cacher
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install alexklein-apt_cacher --version 1.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



alexklein/apt_cacher — version 1.0.0 Apr 21st 2016


Build Status

Table of Contents

  1. Description
  2. Setup - The basics of getting started with apt_cacher
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


The apt_cacher module installs, configures and manages the apt-cacher service.


What apt_cacher affects

The apt_cacher module installs apt-cacher. All the customs settings are saved in a fragment file in /etc/apt-cacher/conf.d.

Beginning with apt_cacher

To install the package apt-cacher with the default configuration:

class { 'apt_cacher': }


To customize your apt-cacher, you can pass parameters:

class { 'apt_cacher': 
  admin_email         => '',
  distinct_namespaces => 1,

Or you can set custom values in hiera:

apt_cacher::admin_email: ''
apt_cacher::distinct_namespaces: 1



All the parameters for this module match the actual parameters for apt-cacher:

  • group (default www-data)
  • user (default www-data)
  • cache_dir
  • log_dir
  • admin_email
  • daemon_port
  • daemon_addr
  • offline_mode
  • checksum
  • concurrent_import_limit
  • http_proxy
  • http_proxy_auth
  • use_proxy
  • use_proxy_auth
  • interface
  • limit
  • path_map
  • distinct_namespaces
  • allowed_hosts
  • denied_hosts
  • allowed_ssl_locations
  • allowed_ssl_ports
  • allowed_locations
  • ubuntu_release_names
  • generate_reports
  • clear_cache
  • debug
  • package_files_regexp
  • pdiff_files_regexp
  • index_files_regexp
  • installer_files_regexp
  • checksum_files_regexp
  • skip_checksum_files_regexp
  • soap_url_regexp

Please look at man apt-cacher for examples and default values.


This module is only available for Debian and Ubuntu.


Open to any modifications.