Forge Home


Install and configure an apt-cacher-ng server.


38,889 latest version

4.6 quality score

Version information

  • 1.0.1 (latest)
  • 1.0.0
  • 0.1.7
  • 0.1.6
  • 0.1.5
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Mar 28th 2016
This version is compatible with:
  • Ubuntu

Start using this module

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

Add this module to your Puppetfile:

mod 'markhellewell-aptcacherng', '1.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add markhellewell-aptcacherng
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install markhellewell-aptcacherng --version 1.0.1

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.



markhellewell/aptcacherng — version 1.0.1 Mar 28th 2016


Puppet Forge Version Puppet Forge Downloads Build Status Puppet Forge Score

Table of Contents

  1. Overview
  2. Setup
  3. Usage
  4. Limitations
  5. Development


A puppet module to manage an apt-cacher-ng service and its configuration. Applying aptcacherng to a node will configure the node to act as a caching proxy for apt (and other) package management systems.


What aptcacherng affects

Use of aptcacherng causes installation of the apt-cacher-ng package, generation of the config file /etc/apt-cacher-ng/acng.conf, and the apt-cacher-ng service to run and be enabled.

Beginning with aptcacherng

Quickest way to get an apt caching proxy using defaults:

class {'aptcacherng':}

This will apply all resources and leave you with apt-cacher-ng running on port 3142.


Simply declaring the aptcacherng class for a node, will apply the class using standard apt-cacher-ng defaults:

  • CacheDir: /var/cache/apt-cacher-ng
  • LogDir: /var/log/apt-cacher-ng
  • Port: 3142
  • ReportPage: acng-report.html
  • ExTreshold: 4

All apt-cacher-ng config file directives are available as parameters to the aptcacherng class. For example, to change the directory where apt-cacher-ng will store its cache:

class {'aptcacherng':
    cachedir => '/data/apt/apt-cacher-ng'

Or, in a YAML hiera data source—for example—you could make use of automatic parameter lookups like so:

  - aptcacherng

aptcacherng::cachedir: "/data/apt/apt-cacher-ng"

If you wish to make aptcacherng install a specific apt-cacher-ng package, you may pass the packagename string parameter when declaring the class.

If you're using the puppetlabs-apt module, telling apt to use your apt-cacher-ng service is simple. For example:

class {'apt':
    proxy_host => '',
    proxy_port => '3142',


Only debian based distributions are currently supported.


Development takes place in the puppet-aptcacherng GitHub repository. Pull Requests happily accepted.