Forge Home


A series of types/providers to manage Network interface proxies on OS X


9,820 latest version

3.9 quality score

Version information

  • 0.0.2 (latest)
  • 0.0.1
released Nov 25th 2013

Start using this module

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

Add this module to your Puppetfile:

mod 'glarizza-mac_proxy', '0.0.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add glarizza-mac_proxy
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install glarizza-mac_proxy --version 0.0.2

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.



glarizza/mac_proxy — version 0.0.2 Nov 25th 2013

OS X Proxy Puppet Module

This module contains all the files necessary for managing the following with Puppet:

  • FTP Proxy server/port
  • Web Proxy server/port
  • Gopher Proxy server/port
  • Secure Proxy server/port
  • Streaming Proxy server/port
  • Socks Proxy server/port
  • Auto Proxy URL
  • Proxy bypass domains

How to use

  • Install the module in your Puppet modulepath (If you don't know your main Puppet modulepath, you can find it with sudo puppet config print modulepath
  • Discover all resources with sudo puppet resource mac_web_proxy (or appropriate proxy type)
  • Declare and enforce configuration like you would normally with Puppet

Puppet Types

  • mac_web_proxy
  • mac_ftp_proxy
  • mac_gopher_proxy
  • mac_secure_proxy
  • mac_socks_proxy
  • mac_auto_proxy
  • mac_proxy_bypassdomains

Declaring a proxy resource

The web, ftp, gopher, secure, and socks proxy types are all declared similarly and use the same properties/parameters:

mac_web_proxy { 'Ethernet':
  ensure       => present,
  proxy_server => '',
  proxy_url    => '8080'

The auto proxy only accepts a proxy_server property, and does not accept a proxy_port property:

mac_auto_proxy { 'Ethernet':
  ensure       => present,
  proxy_server => '',

The mac_proxy_bypassdomains type accepts an array for the domain property and sets the domains that should bypass the proxies for that network interface:

mac_proxy_bypassdomains { 'Ethernet':
  domains => ['*', '', ''],