Forge Home


A puppet module to manage the proxy settings within Window's Internet Settings snap-in


6,051 latest version

4.5 quality score

Version information

  • 0.2.0 (latest)
released Aug 24th 2018
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
  • , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'beersy-win_proxy', '0.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add beersy-win_proxy
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install beersy-win_proxy --version 0.2.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.



beersy/win_proxy — version 0.2.0 Aug 24th 2018


Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with win_proxy
  4. Usage - Configuration options and additional functionality
  5. Example
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module


This module allows the user to modify the settings of their proxies used on Windows machines as set in the Internet Settings snap-in within the Control Panel. This module was directly tested against Windows Server 2012 R2 but should work against most Windows versions. For reference on this snap-in, please see the following page:

Module Description

This module allows you to set the following settings within the snap in.

  • Automatically Detect Settings
  • Use Automatic Configuration Script
    • Address
  • Use a proxy server for your LAN (These settings will not apply to dial-up or VPN connections)
    • Address
    • Port
    • Bypass proxy server for local address

At this time this module does not allow for more advanced configurations past these settings.


What win_proxy affects

This module will affect the registry settings behind these entries within the HKCU registry area.

Setup Requirements

This module requires the puppetlabs-stdlib and puppetlabs-powershell modules.

Beginning with win_proxy

This module by default will enable "Automatically Detect Settings" within the snap-in. If you need additional customization please see the usage details below.



#####$autodetect This accepts a boolean for whether "Automatically Detect Settings" should be enabled or disabled (Default: true)

#####$staticproxy This accepts a boolean for whether "Use a proxy server for your LAN" should be enabled or disabled (Default: false)

#####$proxyserver This accepts a string containing the static proxy server you would like to use. It will only take affect if $staticproxy is true It should be formatted as 'hostname:port'. (Default: '')

#####$localoverride This accepts a boolean for whether "Bypass proxy server for local addresses" should be enabled or disabled. This only takes affect if $staticproxy is true. (Default: false)

#####$autoscript This accepts a boolean as to whether "Use automatic configuration script" should be enabled or disabled. (Default: false)

#####$autoscript_url This accepts a string containing the address you would like to use if utilizing "Use automatic configuration script". This will only take affect if $autoscript is set to true. (Default: '')


class {'win_proxy':
  autodetect     => true,
  staticproxy    => true,
  proxyserver    => '',
  localoverride  => false,
  autoscript     => false,
  autoscript_url => 'http://myproxyscript.lan/script.pac',


Currently tested only against Windows Server 2012 R2.


All contributions are welcome. Feel free to fork and contribute or file an issue.

Release Notes