Forge Home


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


6,520 latest version

4.5 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

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