Provides a simple way to manage various proxies

Miami University of Ohio



1,096 latest version

5.0 quality score

Version information

  • 2.0.1 (latest)
  • 2.0.0
  • 1.7.0
  • 1.6.0
  • 1.5.3
  • 1.0.0
  • 0.1.1
released Aug 24th 2020
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • RedHat

Start using this module

Tags: proxy, linux


MiamiOH/httpproxy — version 2.0.1 Aug 24th 2020


Build Status Puppet Forge Puppet Forge Downloads Puppet Forge Score

Table of Contents

  1. Overview
  2. Usage - Configuration options and additional functionality
  3. Reference - An under-the-hood peek at what the module is doing and how
  4. Limitations - OS compatibility, etc.
  5. Contributors


WARNING: This module will default to wiping any proxies in profile.d, apt conf.d, and yum.conf. Pass false to disable the module from handling those software packages.

This module was created to streamline proxy management of popular software. It can place and remove proxies in profile.d, apt, yum, and wget. Currently only http (no https) proxies are supported.


class { '::httpproxy':
  wget            => true,
  profiled        => true,
  packagemanager  => true,
  http_proxy      => '',
  http_proxy_port => '80'

Puppet will manage the proxy for the desired software when its boolean is set to true. When a proxy is entered, puppet will ensure that the proxy is present. If a proxy is left undefined, puppet will remove whatever proxy it placed (ensure absent). If the boolean is set to false, nothing will be removed or placed.

The no_proxy parameter takes a comma separated string of addresses to be ignored by the profile.d proxy.


httpproxy uses the Unibets profile.d management module to manage proxies in profile.d. The puppetlabs/inifile resource is used to manage the yum and wget proxies. The apt proxy is managed via the puppetlabs/apt module.

Please contribute, pull requests are welcome. The more proxies that can be managed the better.


This module has been tested against Puppet 4, CentOS 5,6,7, and Ubuntu 14.04.


Chris Edester and Michael Callahan