2.4.0

As part of this release we had 20 issues closed.

Bug Fixes

• Fix - Update tab completions for compatibility with PowerShell 7.4+ - see #3364.
• Fix - Prevent dependency resolution from unexpectedly downgrading packages - see #3461.
• Fix - Do not install packages if dependencies fail to install - see #3487.
• Fix - Ensure package folders are correctly restored if unexpected failures occur during upgrade - see #3489.
• Fix - Use the user-provided page size when querying repositories - see #3502.
• Fix - Ensure .arguments files that cannot be decrypted do not prevent running Chocolatey CLI commands - see #3503.
• Fix - Ensure invalid .arguments files do not prevent running Chocolatey CLI commands - see #3513.

Deprecated Feature

• Deprecate the Install-ChocolateyPinnedTaskBarItem helper function - see #3520.

Documentation

• Update build instructions - see #3467.
• Fixed parameter name typo in the chocolateyInstall template - see #3504.

Improvements

• Rework build process to remove the use of -unpackself command - see #3427.
• Dependency resolution during install can be slow - see #3451.
• Remove historical folder migration logic from chocolateysetup.psm1 - see #3501.
• Updated the bundled version of 7zip to 24.08 - see #3505.
• Provide better information through the user agent when querying remote repositories - see #3526.

2.3.0

Read our blog post about this release.

As part of this release we had 33 issues closed.

Deprecated Feature

• Deprecate unpackself command - see #3426.

Features

• Save software install location for future use - see #3315.
• Allow viewing package creation validation rules via new choco rule command - see #3381.

Bug Fixes

• Fix - Ensure Install-ChocolateyInstallPackage does not add a trailing space to silent arguments - see #2345.
• Fix - Prevent creation of Tools folder via the MSI installer #3307.
• Fix - Ensure Install-ChocolateyPath adds a new entry to the PATH when part of it is already there - see #3318.
• Fix - Using Install-ChocolateyPath -PathType Machine in a non-admin context spawns PowerShell endlessly and never completes - see #3424.

Improvements

• Allow all packages from a source to be installed - see #23.
• Allow the ability to add the configured sources when using the --source option - see #72.
• Add Uninstall-ChocolateyPath function to manage removing entries from PATH - see #310.
• Verify the checksum of a package before installation, and fail if not matched - see #1144.
• Show remembered arguments for packages - see #1310.
• Add the source URL where the package was downloaded from, to the output of the choco install and choco upgrade commands - see #1485.
• choco apikey - Exit 2 if nothing to do (enhanced exit code) - see #1759.
• choco config - Exit 2 if nothing to do (enhanced exit code) - see #1760.
• choco feature - Exit 2 if nothing to do (enhanced exit code) - see #1761.
• choco pin - Exit 2 if nothing to do (enhanced exit code) - see #1762.
• choco source - Exit 2 if nothing to do (enhanced exit code) - see #1764.
• choco upgrade - Exit 2 if nothing to do (enhanced exit code) - see #2200.
• Allow upgrading a pinned package without removing the pin beforehand - see #2050.
• Update OS_NAME environment variable to support Windows 11 and Server 2019/2022 - see #2754.
• Rerunning Install Script after reboot should not be necessary - see #3327.
• Improve package dependency lookup when an exact version is defined - see #3433.

Documentation

• Clarify what --include-programs option does, in the help output - see #147.
• Fix grammar in the pending reboot warning message - see #3164.
• Improve the feature DisableCompatibilityChecks help description - see #3296.
• Fix typos and punctuation in choco feature and choco config error output - see #3324.
• Clarify Proxy BypassList value must be a regular expression, in the help output - see #3401.
• Remove reference of unused zip.sh from README.md file - see #3402.

2.2.2

As part of this release we had 1 issue closed.

Warning

There is a bug in Chocolatey CLI v2.2.0 that prevents upgrading if you have a package dependency that only has pre-release versions (or if the package is no longer available on the sources that you have available). If you receive the error Object reference not set to an instance of an object please uninstall the package that only has pre-release versions available (or which no longer exists on the sources you have available), upgrade Chocolatey CLI, and re-install the package that was uninstalled.

This bug has been fixed in this release of Chocolatey CLI.

Warning

Refer to our Upgrade Guide for recommendations before upgrading from 1.x versions to 2.x.

Bug Fix

• Fix - Unable to upgrade a package if a dependency only contains pre-release package versions, or if package no longer exists on available sources - see #3292.

2.2.1

Warning

Chocolatey CLI 2.2.1 was removed from public availability due to a bug identified just prior to the release.

Warning

Refer to our Upgrade Guide for recommendations before upgrading from 1.x versions to 2.x.

As part of this release we had 3 issues closed.

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.

2.2.0

Warning

Refer to our Upgrade Guide for recommendations before upgrading from 1.x versions to 2.x.

As part of this release we had 10 issues closed.

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.

2.1.0

Warning

Refer to our Upgrade Guide for recommendations before upgrading from 1.x versions to 2.x.

As part of this release we had 17 issues closed.

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.

2.1.0-alpha-20230614

Warning

This is a pre-release version of Chocolatey CLI and it is NOT suitable for production use! A pre-release version will have bugs that could have a detrimental impact to your environment. Ensure all necessary due diligence steps are taken before using in your environment.

Warning

This pre-release version of Chocolatey CLI only works with the alpha version of the Chocolatey Licensed Extension.

Note

The issue that was introduced in the previous alpha release regarding the open ended search query has been addressed in this alpha release.

Note

Before installing this prerelease version, we would recommend that you read through the Upgrade Instructions for moving to the major version of Chocolatey CLI.

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.

Documentation

• Update contributing documentation to be clearer for newcomers - see #3108.

2.1.0-alpha-20230608

Warning

This is a pre-release version of Chocolatey CLI and it is NOT suitable for production use! A pre-release version will have bugs that could have a detrimental impact to your environment. Ensure all necessary due diligence steps are taken before using in your environment.

Warning

This pre-release version of Chocolatey CLI only works with the alpha version of the Chocolatey Licensed Extension.

Known Issues

There is a known issue when attempting to do an open ended search query where the Chocolatey Licensed feed is in place. For example, if you run the command choco search --source chocolatey.licensed you will get the following error message returned:

The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters.

A fix has been found for this problem, and will be released in a future alpha release.

Bug Fixes

• 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.

Improvements

• Performance degradation after upgrading to version Chocolatey CLI v2.0.0 - see #3183.
• choco search command does not use previously cached results - see #3125.

2.0.0

Warning

Refer to our Upgrade Guide for recommendations before upgrading from 1.x versions to 2.x.

As part of this release we had 52 issues closed.

Breaking Changes

• Change default behavior of choco list to be local only - see #158.
• Prevent usage of leading 0 in package version numbers - see #1174.
• choco config list --limit-output does not limit output as expected - see #2013.
• Remove Get-BinRoot Chocolatey helper function - see #2623.
• Remove the default push location when uploading/pushing packages - see #2629.
• Remove deprecated configurations from Config - see #2630.
• Remove deprecated Chocolatey shims (chocolatey, cinst, clist, cpush, cuninst, cup) - see #2642.
• Upgrade to target version 4.8 of the .NET Framework - see #2738.
• Fix spelling mistake in the extract_binary_file_from_assembly function - see #2776.
• Remove side-by-side installs - see #2788.
• Migrate from Rx-* packages to System.Reactive.* packages - see #2896.
• Switch to use only the recommended TLS versions without fallback to earlier insecure options - see #2902.
• Rename or migrate away from custom HashCode class - see #2909.
• Remove WebPI alternative source - see #2980.
• Remove the --remove option in apikey command and replace with remove subcommand - see #2984.
• choco config list should only include information about config - see #2986.
• Disallow passing in a path to a NUPKG file directly when installing/upgrading packages - see #3008.
• Introduce upper limit when querying for packages and warn when threshold is close to being hit - see #3014.

Bug Fixes

• NuGet does not deal with blocking version conflicts from existing installed packages - see #116.
• NuGet doesn't handle conflicts of versions in an install request when HighestVersion dependency - see #507.
• Push command does not honor proxy settings - see #1271.
• Filenames that contain apostrophes aren't handled correctly when calculating checksums - see #1590.
• Chocolatey CLI does not override NuGet proxy with its own - see #1720.
• choco pack command fails with error on Linux when using file greater than 2 GB - see #2278.
• choco info command with no package id defined returns 0 packages found rather than provide a warning - see #2899.

Documentation

• Fix broken URLs in repository README file - see #2888.
• Update Minimum Windows Server OS to Server 2008 R2 - see #2903.
• Update package files to reflect current CCR moderation requirements - see #2920.
• Fix typos and spelling errors - see #2990.

Improvements

• Ability to specify a default source when doing choco push - see #62.
• Upgrade to target version 3.1.0 of Chocolatey.NuGet.Client assemblies - see #508.
• Support Semantic Versioning 2.0.0 (semver) - see #1610.
• choco info command doesn't show package URL - see #1728.
• Ensure that the client version used when querying a repository is the version of the underlying NuGet.Client library - see #1935.
• Alphabetically sort the output from the feature config source and apikey list command - see #2814.
• Add ability to get status of an individual feature (choco feature get) - see #2815.
• Provide ability to navigate directly to online version of help documentation for a command - see #2867.
• PowerShell tab completion should only show commands/options for currently installed license - see #2887.
• Adjust visibility / remove non-interface public methods on CygwinService - see #3028.
• MSI Build should be present in this repository - see #3061.
• Chocolatey products should no longer warn about possible errors when upgrading from versions before 1.0.0 - see #3097.
• Sort list of installed/upgraded packages - see #3112.

1.4.0

As part of this release we had 2 issues closed.

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.