Configuration Management Integration (Free / Open Source)

Chocolatey integrates with several infrastructure automation tools!

With most of these tools, the interface you would interact with Chocolatey would be through the tool or through the interfaces of the tool, like in scripts.


Ansible has the win_chocolatey module that manages both packages and the installation of Chocolatey itself.

  name: git
  source: https://my.internal.repository/api/v2/



Boxstarter is a lightweight configuration management utility.

Repeatable, reboot resilient Windows environment installations made easy using Chocolatey packages. When its time to repave either bare metal or virtualized instances, locally or on a remote machine, Boxstarter can automate both trivial and highly complex installations. Compatible with all Windows versions from Windows 7/2008 R2 forward.



Chef 12.7+ has a built-in chocolatey_package resource to use with Chocolatey.

chocolatey_package 'git' do
  action :install
  source 'https://my.internal.repository/api/v2'

Resource -

When you need to also install Chocolatey, you would use the community cookbook to do so. The cookbook is maintained by the Chocolatey team. It has a package resource that can be used with older Chef versions.

include_recipe 'chocolatey'

Cookbook -


Here's a more in depth example from Nordstrom:

include_recipe 'chocolatey'

home = Dir.home
).each do |directory|
  directory directory

packages = node['chefdk_bootstrap']['package']

packages.each do |pkg, install|
  include_recipe "#{cookbook_name}::#{pkg}" if install

Another example from Facebook:

node.default['cpe_choco']['sources']['bacon'] =
  'source' => '',

Octopus Deploy

Octopus is a friendly deployment automation tool for .NET developers. It integrates with lots of utilities, and they have a template for installing Chocolatey packages:


PowerShell DSC

PowerShell DSC (Desired State Configuration) has a cChoco module that can manage both packages and the installation of Chocolatey itself.

  cChocoInstaller installChoco
    InstallDir = "c:\ProgramData\chocolatey"

  cChocoPackageInstaller installGit
     Name = "git"
     DependsOn = "[cChocoInstaller]installChoco"


PowerShell PackageManagement

NOTE: Chocolatey has a prototype provider for the built-in package manager on Windows 10/Windows Server 2016 that was created by Microsoft awhile back. It is not fully functional and it may have security issues. If you want to use Chocolatey with PackageManagement, we recommend using ChocolateyGet, which is a nice bridge until an official one is implemented. No ETA has been defined.

PowerShell PackageManagement (aka OneGet) is a package manager aggregator that depends on the existence of package managers as providers to work, one of which is Chocolatey. For a pretty comprehensive post about what PackageManagement is and what it is not, see the PackageManagement Blog post on 10 things about OneGet that are completely different than you think.


PSDeploy is a quick and dirty module to simplify PowerShell based deployments.

Deploy SingleChocolateyPackage {
    By Chocolatey {
        FromSource 'c:\ChocolateyPackages\examplepackage.0.1.1.nupkg'
        To ""
        WithOptions @{
            ApiKey = 'yourAPIkey'
            Force = $true



Puppet has a Supported module for Chocolatey puppetlabs/chocolatey. Note that there is also a chocolatey/chocolatey module, the supported module is a drop in replacement for the chocolatey/chocolatey module - please use puppetlabs/chocolatey as it has full configuration of Chocolatey.

include chocolatey

package { 'git':
  ensure   => latest,
  provider => 'chocolatey',
  source   => 'https://my.internal.repository/api/v2',

Puppet has some great documentation on getting started with Chocolatey. Be sure to check that out at Using Windows modules.

The Chocolatey team is most familiar with Puppet and has written some documentation for using Puppet with Chocolatey. Please see

Note: if anyone would be interested in providing documentation similar to the above for other frameworks, we'd accept it as Pull Requests at



Salt has a Chocolatey module that manages both packages and the installation of Chocolatey itself.

salt '*' chocolatey.bootstrap
salt '*' chocolatey.install git


System Center Configuration Manager

Chocolatey integrates with SCCM by handling the software management, and pointing to distribution points as the source for packages. This allows folks to get packages and larger binaries out to their network without constraints and still take advantage of Chocolatey's fantastic abilities!

To direct Chocolatey package installs, you can still write GPOs to ensure this.