Known Issues

See this list for known issues with this pre-release.

Bugs

• Chocolatey does not override NuGet proxy with its own - see #1720.
• When no hook scripts are installed you cannot install/upgrade a package on a system using PowerShell 2 - see #3088.
• Prevent install/upgrade failure when using multiple sources and one or more of them cannot be reached.

Enhancements

• Chocolatey products should no longer warn about possible errors when upgrading from versions before 1.0.0 - see #3097.
• All the different ways that a proxy can be configured (environment variables, chocolatey.config file, command arguments) have been tested and verified to work as expected.

Known Issues

See this list for known issues with this pre-release.

Breaking Changes

In addition to the breaking changes listed in the previous alpha release below, the following changes have been made:

• choco config list should only include information about config - see #2986.
• Remove the --remove option in choco apikey command and replace with remove subcommand - see #2984.
• Remove WebPI alternative source - see #2980.
• Rename or migrate away from custom HashCode class - see #2909.
• Migrate from Rx-* packages to System.Reactive.* packages - see #2896.
• Remove side-by-side installs - see #2788.
• Fix spelling mistake in the extract_binary_file_from_assembly function - see #2776.
• Remove deprecated Chocolatey shims (chocolatey, cinst, clist, cpush, cuninst, cup) - see #2642.
• Remove deprecated configurations from Config - see #2630.
• Remove the default push location when uploading/pushing packages - see #2629.
• Remove Get-BinRoot Chocolatey helper function - see #2623.
• choco config list --limit-output does not limit output as expected - see #2013.
• Change default behavior of choco list to be local only - see #158.

Enhancements

• Ability to specify a default source when doing choco push - see #62.
• Remove re-instated Chocolatey commands which were added in v1.0.1 - see #2678.

As part of this release we had 1 issue closed.

Bug Fix

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

Known Issues

See this list for known issues with this pre-release.

Bug Fixes

• Fix choco search command that was providing invalid results when using the --version option.
• Fix dependency resolution problems during execution of choco upgrade and choco install.

Enhancements

• Add back support for the --disable-repository-optimizations option which was missing in previous alpha releases.
• Improvements made to warnings that are emitted when a dependency fails to be resolved during a choco upgrade or choco install.

Known Issues

See this list for known issues with this pre-release.

Breaking Changes

In addition to the breaking changes listed in the previous alpha release below, the following changes have been made:

• Introduce upper limit when querying for packages and warn when threshold is close to being hit - see 3014.
• Disallow passing in a path to a NUPKG file directly when installing/upgrading packages - see 3008.

Enhancement

• Add back validation messages after upgrade to NuGet v3+ - see 3000.

Documentation

• Fix typos and spelling errors - see 2990.

As part of this release we had 6 issues closed.

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

Known Issues

See this list for known issues with this pre-release.

Breaking Changes

• Upgrade to target version 4.8 of the .NET Framework - see #2738.
• Prevent usage of leading 0 in package version numbers - see #1174.

Bugs

• choco pack command fails with error on Linux when using a file greater than 2 GB - see #2278.
• Filenames that contain apostrophes aren't handled correctly when calculating checksums - see #1590

Documentation

• Fix broken URLs in repository README file - see #2888.
• Update package files to reflect current CCR moderation requirements - see #2920.

Enhancements

• Upgrade to target version 6.4.0 of NuGet.Client assemblies - see #508.
• Support Semantic Versioning 2.0.0 (semver) - see #1610.

Bug Fixes

• Running choco new --file returns "Cannot Combine Path" Error when Chocolatey Licensed Extension is installed and other assemblies are present in the extensions folder - see #2865
• Selecting [A] Yes to all at package script prompt does not work correctly - see #2872
• Attempting to upgrade multiple packages at once causes an error to be thrown about configuration backups - see #2884

As part of this release we had 29 issues closed.

Feature

• Allow post/pre hooks to run on upgrade/install/uninstall - see #1185

Deprecated Features

• Deprecate side-by-side installs - see #2787

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
• Change source type on source runners to be a generic string - see #2791
• Remove trailing semicolon in templates and tests - see #2807

Documentation

• Minor spelling errors in chocolatey/choco - see #2465
• Update brand names - see #2747

Bug Fixes

• Fix - Python alternate source does not handle all keyword correctly - see #2540
• Fix - Incorrect error message is displayed when chocolatey.config becomes corrupt - see #2525
• 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 - see #1896
• Fix - Windows PowerShell incorrectly identifies a PowerShell file that is UTF8 encoded with a BOM as being signed if it is a single newline - see #2663
• Fix - Unable to install Chocolatey using PowerShell Core - see #2083

Improvements

• Support installation checks for incompatible Licensed Extension when running choco upgrade chocolatey - see #2659
• Support runtime checks for incompatible Chocolatey CLI and Chocolatey Licensed Extension versions - see #2660
  • 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 #2650

Release Video

A short video explaining what is included in this release can be found here: