choco

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.

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.

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 beta version of the Chocolatey Licensed Extension.

Note

If you run into any problems when using this beta version of Chocolatey CLI we would ask that you comment on this discussion, which is where we will be collating issues, and providing workarounds, etc. We will not be accepting issues raised against this beta release.

Known Issues

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

Breaking Change

• Switch to use only the recommended TLS versions without fallback to earlier insecure options - see #2902.

Bug Fixes

• Fix - choco info command with no package id defined returns 0 packages found rather than provide a warning - see #2899.
• Fix - Chocolatey CLI does not override NuGet proxy with its own - see #1720.
• Fix - Ensure that correct count query is used when querying oData feeds.

Enhancements

• PowerShell tab completion should only show commands/options for currently installed license - see #2887.
• Alphabetically sort the output from the feature config source and apikey list command - see #2814.
• Add explicit handling for choco list -li to provide backwards compatibility - related to #158.
• Add ability to get status of an individual feature (choco feature get) - see #2815.
• Ensure that the client version used when querying a repository is the version of the underlying NuGet.Client library - see #1935.

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 beta version of the Chocolatey Licensed Extension.

Note

If you run into any problems when using this beta version of Chocolatey CLI we would ask that you comment on this discussion, which is where we will be collating issues, and providing workarounds, etc. We will not be accepting issues raised against this beta release.

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.

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 beta version of the Chocolatey Licensed Extension.

Note

If you run into any problems when using this beta version of Chocolatey CLI we would ask that you comment on this discussion, which is where we will be collating issues, and providing workarounds, etc. We will not be accepting issues raised against this beta release.

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.

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

If you run into any problems when using this alpha version of Chocolatey CLI we would ask that you comment on this discussion, which is where we will be collating issues, and providing workarounds, etc. We will not be accepting issues raised against this alpha release.

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.

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

If you run into any problems when using this alpha version of Chocolatey CLI we would ask that you comment on this discussion, which is where we will be collating issues, and providing workarounds, etc. We will not be accepting issues raised against this alpha release.

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

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.

📝 NOTE

As part of this release, we have added the functionality to allow officially signed extensions, other than Chocolatey Licensed Extension, to be loaded dynamically. See #2693.

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

⚠️ WARNING

If you use Chocolatey Licensed Extension you will need to install v2.2.0 of Chocolatey Licensed Extension to use all the new functionality that has been added to Chocolatey CLI v0.11.0.

Breaking Changes

• Disable importing / loading of DLL in the extension folder - see #2333
• choco list -e -a returns pre-releases even when --pre is not passed - see #2304

Bug Fixes

• Fix - Prevent creation of empty nuget.config in user appdata folder - see #2233
• Fix - Upgrade all with remembered arguments changes packages to pre-release - see #2111
• Fix - Software applications are being reported as not being managed by Chocolatey when their associated package is installed - see #2092
• Fix - Unable to remove API Key with choco apikey command - see #1889
• Fix - Not all package versions are returned when running running choco list --all-versions --exact - see #1843
• Fix - Upgrade all reuses overridden package parameters when useRememberedArgumentsForUpgrades feature is turned on - see #1443
• Fix - choco pack fails when running on Mono when current directory is not the same one that contains the .nuspec being packed - see #2263
• Fix - Running choco pack on Mono on Linux will not include any files in .nupkg if there is no files element in the .nuspec - see #2258
• Fix - Nuspec files with forward slash creates nested layer of directories when packed on Windows - see #2166
• Fix - Prevent loading of Chocolatey GUI Licensed Extension assembly - see #2078
• Fix - Working directory always being replaced with configured cache location when using Start-ChocolateyProcessAsAdmin - see #2051
• Fix - Temp location can change unexpectedly when using System credentials - see #2044
• Fix - Incorrect output regarding package files when package can't be found to be downloaded - see #1962

Improvements

• [Security] XML External Entity attack in log4net (CVE-2018-1285) - see #2266
• Provide ability to export all currently installed packages to a packages.config file - see #357
• Provide ability to execute PowerShell script right before installation starts when using Install-ChocolateyPackage - see #1060
• Add ChocolateyExitOnRebootDetected feature setting to environment variables for usage within package scripts - see #1983
• Only search top level package folders when running the remove pending packages task - see #1866
• Change default repository in the chocolatey.config to community.chocolatey.org - see #2231
• Support UnzipLocation as an alias to Destination parameter in the Get-ChocolateyUnzip function - see #2203
• API - Allow Lets.GetChocolatey to not initialize logging - see #2124
• Provide ability to install msp patch files using Install-ChocolateyInstallPackage function - see #2112
• Add ability to use authorization headers in the Get-WebFile function - see #1998
• Ensure nuspec files generated from the choco new command use UTF-8 without a byte order mark - see #1364
• Provide top level help command explaining what commands can be executed - see #944
• Ensure correct path separator in nuspec files is used on different operating systems - see #502
• Remove unused variable in uninstall template generated from choco new command - see #2114

Documentation

• Clarify the SpecificFolder parameter for helper functions - see #2190
• Update deprecation notice to use outdated command when using version command - see #2048
• Include information about --version option in choco help documentation - see #2049
• Fix examples for Install-ChocolateyPackage function - see #1899
• Terminology improvements in choco.exe help output - see #1861
• Wrong error message shown when using Get-ChocolateyWebFile and forcex86 - see #1859

Release Video

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

Bug Fix

• Fix - Chocolatey Licensed Extension is not loaded into PowerShell process when using v0.11.0 - see #2340

Release Video

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

Bug Fix

• Fix - Setting of Authorization header in Get-WebFile cmdlet does not work - see #2374

Release Video

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

Bug Fixes

• Fix - Chocolatey fails to load all PowerShell helper cmdlets when attempting to loads modules - see #2412
• Fix - Chocolateys PowerShell Installer Module uses non PowerShell 2 compatible syntax - see #2398
• Fix - Running Chocolatey CLI with an expired Chocolatey License can result in non-commercial commands failing to run - see #2289
• Fix - Installing from packages.config doesn't support installing from other sources (e.g. windowsfeatures, python, etc) - see #877
• Fix - Quoted InstallLocation in .registry file results in errors when attempting to automatically uninstall application - see #2336

Release Video

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

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:

Bug Fix

• Fix - When Chocolatey CLI v1.0.0 attempts to load Chocolatey Licensed Extension versions less than v4.0.0, it halts execution with an unclear and unhelpful error message - see #2656

Release Video

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

Breaking Changes

• Remove deprecated Chocolatey commands and shims - see #2468
• Remove deprecated Chocolatey helper functions - see #2469
• Remove the cpack command alias - see #89
• Remove the fallback to using old URL for Chocolatey Community Repository when pushing packages - see #2628
• Remove deprecated -t argument for the push command - see #2627
• Ensure that Chocolatey correctly handles removed features when running the choco feature command - see #2538

Improvements

• Update to use version v1.0.0 of shimgen - see #2602
• Installation of Chocolatey should add a more descriptive comment when adding Chocolatey tab-completion module to profile - see #2443

Documentation

• Update deprecation notice for push command to mention that the default source will be removed in v2.0.0 - see #2634
• Mark Chocolatey shims (chocolatey. cinst, clist, cpush, cuninst, cup) as deprecated - see #2641
• Mark Get-BinRoot Chocolatey helper function as deprecated - see #2470
• Add deprecation notices for all things that are set to change in v2.0.0 - see #2462
• Provide better clarity regarding the license terms for using Chocolatey and shimgen - see #2549, #2615, and 2614
• Document the fact that the Source switch doesn't do anything when running the command choco list --lo - see #2545
• Update warning that is shown regarding using a trial license of Chocolatey - see #2407

Release Video

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

Bug Fixes

• Fix - Installation of Chocolatey fails when running under "AllSigned" execution policy - see #2539
• Fix - Output from "choco template -h" references wrong subcommand in usage statement - see #2546

Release Video

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

⚠️ WARNING

If you use Chocolatey Licensed Extension you will need to install v3.1.0 of Chocolatey Licensed Extension to use all the new functionality that has been added to Chocolatey CLI v0.12.0.

Breaking Changes

• Remove ScriptsCheckLastExitCode feature - see #2522

Features

• Add command (choco template) to retrieve information about currently installed package templates - see #449
• Add configuration option for default template name to be used in conjunction with the choco new command - see #2377

Bug Fixes

• Fix - Building a package on Linux fails if the description has encoded xml special character(s) - see #2382
• Fix - Building a package on Linux fails if nuspec does not have files element - see #2379
• Fix - choco pack command fails on non-Windows when the nupkg already exists - see #2076
• Fix - Install location is invalid on Linux if the ChocolateyInstall environment variable is not set - see #2370
• Fix - During upgrade, removal of old choco.exe does not use absolute path on Linux - see #2369
• Fix - Attempting to use ProtectedData.Protect with LocalMachine scope fails when run on non-Windows system as a non-root user - see #2437
• Fix - Chocolatey packaging script (chocolateyBeforeModify.ps1) incorrectly running on non-Windows platforms - see #2510
• Fix - choco install command ignores install arguments when specifying direct path to nupkg - see #2089
• Fix - Deleting NuGet temp folders fails when running on Linux - see #2383

Improvements

• Warn about unsupported packages when executing Chocolatey on non-Windows platforms - see #2481
• Display install location for purely portable packages - see #2241
• Provide more clarity on errors when attempting to push packages to Chocolatey Community Repository - see #2007
• Support empty directories within Chocolatey template folder - #1003
• Snapshotting of files and config transform has been enabled on non-Windows systems - see #2450
• Prevent usage of alternate Chocolatey installation/upgrade sources on non-Windows systems - see #2424
• Improve response message regarding moderation times when using choco push command - see #2298

Documentation

• Fix outdated bit.ly links in command documentation - see #2401
• Update default template regarding building Chocolatey package on non-Windows systems - see #2384
• Fix version number used in default template - see #2381

Release Video

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