Chocolatey Changelog

What's new in Chocolatey 2.2.2

Aug 8, 2023
  • Bug Fix:
  • Unable to upgrade a package if the package parent only contains pre-release package versions - see #3292.

New in Chocolatey 2.2.1 (Aug 3, 2023)

  • Bug Fixes:
  • Fix - Can't find choco.exe after upgrading Chocolatey with MSI - see #3286.
  • Fix - Unable to do non-elevated operations when cache location is set to restricted directory - see #3291.
  • Dependency Change:
  • Update bundled 7zip executables to v23.01 - see #3285.

New in Chocolatey 2.2.0 (Jul 26, 2023)

  • Bug Fixes:
  • Fix - Upgrading from Chocolatey CLI v2.0.0 to v2.1.0 take a long time to complete when certain other packages are installed - see #3237.
  • Fix - Chocolatey CLI v2.0.0 prompts for credentials when authenticating to a source that is using Windows Authentication - see #3242.
  • Fix - Chocolatey CLI is unable to save HTTP Cache files when running as a non-admin user and the cacheLocation is set to point at the Chocolatey ProgramData folder - see #3264.
  • Improvements:
  • Remove warning message about "smarter than the average bear" - see #3186.
  • Improve overall execution time when performing the choco upgrade all command - see #3231.
  • Expand logging around the exception that is thrown when Chocolatey CLI is unable to communicate with a source - see #3258.
  • Ensure that only Administrators are able to modify files that are stored within the ChocolateyHttpCache folder - see #3281.
  • Documentation:
  • Apply scripting best practices to output which is shown from some Chocolatey CLI validations - see #3238.
  • Improve error message that is shown when defaultPushSource configuration value hasn't been set and no explicit source has been provided - see #3280.

New in Chocolatey 2.1.0 (Jun 29, 2023)

  • Bug Fixes:
  • Fix - Warning about threshold not shown for multiple sources - see #3190.
  • Fix - System proxy settings (automatically detect settings) are no longer used in v2.0.0 - see #3181.
  • Fix - Incorrect implementation of the RuleIdEqualityComparer.Equals method - see #3182.
  • Fix - choco pin remove -n packagename removes pin for a different package - see #3196.
  • Fix - Package version normalization is not being applied everywhere - see #3174.
  • Fix - Chocolatey CLI tries to load the licensed environment settings when the licensed extension assembly is not supposed to be loaded - see #3224.
  • Fix - Initial chocolatey.config configuration file is initialized with empty descriptions - see #3201.
  • Fix - Chocolatey CLI does not use the cachelocation which is configured within the chocolatey.config file - see #3225.
  • Fix - Checking for presence of Chocolatey license file in tab expansion PowerShell script generates $error - see #3218.
  • Improvements:
  • Create PowerShell helper function to read config values - see #2854.
  • Add command to allow purging of cached HTTP queries - see #3194.
  • Provide option for Chocolatey CLI commands to skip cached query results - see #3193.
  • Degraded performance after upgrading to version Chocolatey CLI v2.0.0 - see #3183.
  • choco search command does not use previously cached results - see #3125.
  • Documentation:
  • Update contributing documentation to be clearer for newcomers - see #3108.

New in Chocolatey 2.0.0 (May 31, 2023)

  • Breaking Changes:
  • Change default behavior of choco list to be local only
  • Prevent usage of leading 0 in package version numbers
  • choco config list --limit-output does not limit output as expected
  • Remove Get-BinRoot Chocolatey helper function
  • Remove the default push location when uploading/pushing packages
  • Remove deprecated configurations from Config
  • Remove deprecated Chocolatey shims (chocolatey, cinst, clist, cpush, cuninst, cup)
  • Upgrade to target version 4.8 of the .NET Framework
  • Fix spelling mistake in the extract_binary_file_from_assembly function
  • Remove side-by-side installs
  • Migrate from Rx-* packages to System.Reactive.* packages
  • Switch to use only the recommended TLS versions without fallback to earlier insecure options
  • Rename or migrate away from custom HashCode class
  • Remove WebPI alternative source
  • Remove the --remove option in apikey command and replace with remove subcommand
  • choco config list should only include information about config
  • Disallow passing in a path to a NUPKG file directly when installing/upgrading packages
  • Introduce upper limit when querying for packages and warn when threshold is close to being hit
  • Bug Fixes:
  • NuGet does not deal with blocking version conflicts from existing installed packages
  • NuGet doesn't handle conflicts of versions in an install request when HighestVersion dependency
  • Filenames that contain apostrophes aren't handled correctly when calculating checksums
  • Chocolatey CLI does not override NuGet proxy with its own
  • choco pack command fails with error on Linux when using file greater than 2 GB
  • choco info command with no package id defined returns 0 packages found rather than provide a warning
  • Documentation:
  • Fix broken URLs in repository README file
  • Update Minimum Windows Server OS to Server 2008 R2
  • Update package files to reflect current CCR moderation requirements
  • Fix typos and spelling errors
  • Improvements:
  • Ability to specify a default source when doing choco push
  • Upgrade to target version 3.1.0 of Chocolatey.NuGet.Client assemblies
  • Support Semantic Versioning 2.0.0 (semver)
  • Ensure that the client version used when querying a repository is the version of the underlying NuGet.Client library
  • Alphabetically sort the output from the feature config source and apikey list command
  • Add ability to get status of an individual feature (choco feature get)
  • Provide ability to navigate directly to online version of help documentation for a command
  • PowerShell tab completion should only show commands/options for currently installed license
  • Adjust visibility / remove non-interface public methods on CygwinService
  • MSI Build should be present in this repository
  • Chocolatey products should no longer warn about possible errors when upgrading from versions before 1.0.0
  • Sort list of installed/upgraded packages

New in Chocolatey 1.4.0 (May 10, 2023)

  • Bug Fix:
  • Fix - When no hook scripts and installed you cannot install/upgrade a package on a system using PowerShell 2 - see #3088.
  • Improvement:
  • Ensure the most recent version of Chocolatey-NuGet.Core package is being used - see #3150.

New in Chocolatey 1.3.1 (Mar 15, 2023)

  • Bug Fix:
  • chocolateyBeforeModify.ps1 does not get called for dependent packages - see #1092.

New in Chocolatey 1.3.0 (Feb 15, 2023)

  • Deprecated Features:
  • Deprecate WebPI alternative source - see #2958
  • Deprecate usage of direct path to nupkg or nuspec in choco install command - see #2981
  • Deprecate the --remove option in the apikey command - see #2983
  • Deprecate choco config list including output from features/sources/apikeys etc - see #2985
  • Deprecate unnecessary public methods on CygwinService - see #3026
  • Bug Fixes:
  • File not found error when using --source=cygwin to install packages - see #2953

New in Chocolatey 1.2.0 (Oct 20, 2022)

  • Feature:
  • Allow post/pre hooks to run on upgrade/install/uninstall - see #1185
  • Bug Fixes:
  • Fix - Upgrade all reuses overridden package parameters when useRememberedArgumentsForUpgrades feature is turned on - see #1443
  • Fix - Wrong item set for overriding credentials when using remembered arguments during upgrade - see #2752
  • Fix - Python alternative source doesn't create arguments correctly due to spelling mistake - see #2777
  • Fix - Directory permissions not set when installed from PowerShell 7.2.5 - see #2789
  • Improvements:
  • [Security] Unable to extract files from nupkg when different file name encoding is used - see #2816
  • Add cmdlet for acquiring paths set in environment variables that should not be used directly - see #2860
  • Add support for the --pin option on the install and upgrade commands - see #798
  • Packages.config should include all options (including ignorechecksums) - see #886
  • Add option to skip file logging for Zip file extraction in the Get-ChocolateyUnZip and Install-ChocolateyZipPackage cmdlets - see #1332
  • List parameters in templates - see #2500
  • ChocolateyTabExpansion.ps1 can cause slow auto-complete in PowerShell - see #2556
  • Deprecate side-by-side installs - see #2787
  • Change source type on source runners to be a generic string - see #2791
  • Remove trailing semicolon in templates and tests - see #2807

New in Chocolatey 1.1.0 (Mar 30, 2022)

  • Bug Fixes:
  • Fix - Python alternate source does not handle all keyword correctly
  • Fix - Incorrect error message is displayed when chocolatey.config becomes corrupt
  • Fix - When running the choco outdated command the wrong exit code is shown when there is a pinned package and the --ignore-pinned option is being used
  • Fix - Windows PowerShell incorrectly identifies a PowerShell file that is UTF8 encoded with a BOM as being signed if it is a single newline
  • Fix - Unable to install Chocolatey using PowerShell Core
  • Improvements:
  • Support installation checks for incompatible Licensed Extension when running choco upgrade chocolatey
  • Support runtime checks for incompatible Chocolatey CLI and Chocolatey Licensed Extension versions
  • When triggered, these checks will output a warning and the beginning of the command execution, and at the end of it. To acknowledge these warnings you can
  • either pass the --skip-compatibility-checks option when executing a command, or you can enable the DisableCompatibilityChecks feature using the following
  • command choco feature enable --name="'disableCompatibilityChecks'"
  • Include the latest version of 7zip (v21.07) within Chocolatey installation - see

New in Chocolatey 0.10.16 (Aug 7, 2020)

  • Features:
  • Search only on enter / with delay
  • Create a tile view for local/remote package views
  • Bugs:
  • Creates two directories under ProgramData
  • Remember tile/list view preferences
  • Fix overlay - Title should overlap download section, not the other way around
  • Release notes in about dialog empty
  • sort sequence of name column
  • Improvements:
  • Add missing translations
  • Autofocus search boxes on SourceViews
  • Package description should use all available client space
  • Switch markdown rendering to Markdig.Wpf
  • Drop support for SVG Icons
  • Globalisation - Dutch
  • Documentation:
  • Globalisation - Portuguese
  • Globalisation - Spanish
  • Globalisation - Russian
  • Globalisation - Japanese
  • Globalisation - French
  • Add russian localization
  • Update Swedish translation
  • Added missing translated strings for Norwegian BokmÃ¥l
  • make tooltips localizable and add german translation
  • Add tooling for localization (automatic 'missing string' detection)

New in Chocolatey 0.10.15 (Jun 4, 2019)

  • BUG FIXES:
  • Fix - list/search/info - searching with --exact or info results in Object reference not set to an instance of an object - see #1837

New in Chocolatey 0.10.14 (Jun 4, 2019)

  • BUG FIXES:
  • Fix - feature - Turn off Enhanced Exit Codes by Default - see #1784
  • Fix - Reboot - Pending File Rename Operations check returns true, even after reboot - see #1768
  • Fix - ".registry.bad" files are created for actually valid registry snapshots - see #1581
  • Fix - repositories - Azure DevOps NuGet v2 endpoints don't provide metadata in Packages() queries - fails on "Authors is required." - see #1771
  • Fix - install/upgrade - Chocolatey still fails on failing source repositories - see #1774
  • Fix - Chocolatey remembers --forceX86 value with subsequent packages - see #1772
  • Fix - Get-ChocolateyUnzip / Start-ChocolateyProcessAsAdmin - can fail running a process when working directory is a UNC path - see #1781
  • Fix - Get-UninstallRegistryKey errors when registry keys have bracket characters([]) - see #1788
  • Fix - push - Fix exception message "There was an internal server error, which might mean the package already exists on a Simple OData Server" / OutOfMemoryException - see #1786

New in Chocolatey 0.10.13 (Mar 16, 2019)

  • Bug fixes:
  • Fix - Licensed - Licensed code failing when using licensed PowerShell functions

New in Chocolatey 0.10.12 (Mar 15, 2019)

  • We are pretty excited to finally share a new Chocolatey release! And this release won't disappoint. Loads of bug fixes, enhanced exit codes for search, list, info and outdated when results are returned versus nothing being returned, and some really nice improvements.
  • Perhaps the biggest addition this release is the ability to halt installation if a reboot is detected (#1038). Once you turn this feature on, if you are installing some packages and somewhere in the middle of that there is a need for a reboot, Chocolatey will stop and exit with either exit code 350 (pending reboot prior to anything) or 1604 (install incomplete), indicating a reboot is needed to continue. It won't reboot for you, as it is just a package manager - but it will stop execution so nothing that may error on install is attemtped. You'll need to opt into this feature, so see #1038 for details.
  • If you've long hated the default console colors, we've spent quite a bit of time detecting the background console color and adjusting the colorization output of Chocolatey for this release (#1131). You might give that a whirl and see if you can turn back on console colors for good.
  • We've added the ability to validate the configuration and system state at a global level (#1746). It's early, but expect that we'll do a lot more to really provide good experiences in this area.
  • A bug that is worth noting as fixed is having choco exit when a source fails instead of ignoring it (#612). This is now fixed!
  • The last thing worth noting in the summary is Enhanced Exit Codes, or providing more intentional exit codes that mean something instead of just 0 or 1 (#1758). In this release, outdated and search commands will have additional exit codes that mean something. This is noted in the next section, so please read over and see how to shut off this behavior if you see it breaking any integration you might be using (including your own scripts).
  • BREAKING CHANGES:
  • outdated - Exit 2 when there are packages out of date - see #1602
  • search/list/info - Exit 2 when no results are returned - see #1724
  • We've listed these as breaking changes as it may affect tools that are integrating with Chocolatey and interpreting the output of the exit code. In these cases, it would likely temporarily break those tools until they've had a chance to release new versions of their tools. If you run into this, you simply need to turn off the feature "useEnhancedExitCodes". That is as simple as choco feature disable --name="'useEnhancedExitCodes'" (#1758).
  • FEATURES:
  • Exit when reboot is detected - w/350 for pending & w/1604 on dependency package requiring reboot - see #1038
  • BUG FIXES:
  • [Security] Fix - upgrade - remove automation scripts prior to upgrade even if changed - see #1689
  • [Security] Fix - scripts - Digitally sign the init.ps1 PowerShell file as well - see #1665
  • Fix - When a source fails, choco exits instead of moving to next source - see #612
  • Fix - Upgrade all reuses overridden package parameters when useRememberedArgumentsForUpgrades feature is turned on - see #1443
  • Fix - Passing --execution-timeout=0 doesn't override the default execution timeout in the configuration - see #1747
  • Fix - ChocolateyLastPathUpdate environment variable stores date as locale-specific - see #1604
  • [POSH Host] Fix - install/upgrade/uninstall - PowerShell host should exit with 1 instead of -1 if there is a package error - see #1734
  • Fix - Logging - warnings for ".registry.bad." files are emitted with "-r" switch - see #1580
  • Fix - Logging - ".registry.bad" files are created for actually valid registry snapshots - see #1581
  • Fix - list/search - Listing local packages fails if no sources are enabled - see #661
  • Fix - uninstall - Object reference exception when there are no sources - see #1584
  • Fix - Logging - self-service errors attempting to write to the config when using Chocolatey GUI - see #1649
  • Fix - source list - running with -r fails to escape pipe (|) char - see #1614
  • Fix - source add - Adding a source allows an empty url - see #1582
  • Fix - Get-ChocolateyWebFile - Ensure PSVersionTable is used for PowerShell Version - see #1623
  • Fix - Install-ChocolateyShortcut - Don't create a folder if environment variable is used - see #1687
  • Fix - choco --version includes warnings, breaks version parsing - see #1562
  • Fix - Uninstall-ChocolateyZipPackage failing with Path error - see #1550
  • Fix - Uninstall-ChocolateyZipPackage fails from null passed to Test-Path - see #1546
  • Fix - Get-ChocolateyUnzip - Ensure 7z cmd window is hidden - see #1642
  • [API] Fix - Resolve assemblies globally without locking - see #1735
  • IMPROVEMENTS:
  • [Security] tools - Update 7z to 18.06 Enhancement Security - see #1704
  • [Security] Refreshenv script leaves temporary file behind - see #1549
  • Control enhanced exit codes with a feature switch - see #1758
  • Logging - better default colors - see #1131
  • Validate config / system state across everything - see #1746
  • upgrade - switch for not installing if not installed - see #1646
  • outdated - improve performance of choco outdated - see #1397
  • search/list - Add alias "find" for search - see #1744
  • apikey - Enable removal of API key via CLI - see #1301
  • Logging - Choco --log-file option should create log files relative to current directory - see #1603
  • Logging - Don't suggest installing separate "checksum" tool - see #981
  • template - Add notes to uninstaller file string on how to correctly parse the value from the registry - see #1644
  • Pro/Business - license - If license is found in top-level folder or named wrong, choco should warn - see #1503
  • [API] Allow verifying DI Container in release build - see #1738
  • [API] ability to get consistent hash of ConfigFileSettings class - see #1612