choco

• chocolatey setup

  • install

  • install behind a proxy

  • Non-Administrative install

  • unisntall

• packages

  • install

  • upgrade

• config

  • list

  • proxy

• others

chocolatey setup

[!NOTE|label:references:]

• Installing Chocolatey CLI

• install.ps1

install

• install with cmd.exe

  > @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

• install with powershell.exe

  > Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

install behind a proxy

# cmd.exe
> @powershell -NoProfile -ExecutionPolicy Bypass -Command "[System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET PATH="%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

# powershell.exe
> [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Non-Administrative install

> Get-Content ChocolateyInstallNonAdmin.ps1
# Set directory for installation - Chocolatey does not lock down the directory if not the default
$InstallDir='C:\ProgramData\chocoportable'
$env:ChocolateyInstall="$InstallDir"

# If your PowerShell Execution policy is restrictive, you may
# not be able to get around that. Try setting your session to
# Bypass.
Set-ExecutionPolicy Bypass -Scope Process -Force;

# All install options - offline, proxy, etc at
# https://chocolatey.org/install
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

unisntall

$VerbosePreference = 'Continue'
if (-not $env:ChocolateyInstall) {
  $message = @(
    "The ChocolateyInstall environment variable was not found."
    "Chocolatey is not detected as installed. Nothing to do."
  ) -join "`n"

  Write-Warning $message
  return
}

if (-not (Test-Path $env:ChocolateyInstall)) {
  $message = @(
    "No Chocolatey installation detected at '$env:ChocolateyInstall'."
    "Nothing to do."
  ) -join "`n"

  Write-Warning $message
  return
}

<#
  Using the .NET registry calls is necessary here in order to preserve environment variables embedded in PATH values;
  Powershell's registry provider doesn't provide a method of preserving variable references, and we don't want to
  accidentally overwrite them with absolute path values. Where the registry allows us to see "%SystemRoot%" in a PATH
  entry, PowerShell's registry provider only sees "C:\Windows", for example.
#>
$userKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey('Environment',$true)
$userPath = $userKey.GetValue('PATH', [string]::Empty, 'DoNotExpandEnvironmentNames').ToString()

$machineKey = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\ControlSet001\Control\Session Manager\Environment\',$true)
$machinePath = $machineKey.GetValue('PATH', [string]::Empty, 'DoNotExpandEnvironmentNames').ToString()

$backupPATHs = @(
  "User PATH: $userPath"
  "Machine PATH: $machinePath"
)
$backupFile = "C:\PATH_backups_ChocolateyUninstall.txt"
$backupPATHs | Set-Content -Path $backupFile -Encoding UTF8 -Force

$warningMessage = @"
  This could cause issues after reboot where nothing is found if something goes wrong.
  In that case, look at the backup file for the original PATH values in '$backupFile'.
"@

if ($userPath -like "*$env:ChocolateyInstall*") {
  Write-Verbose "Chocolatey Install location found in User Path. Removing..."
  Write-Warning $warningMessage

  $newUserPATH = @(
      $userPath -split [System.IO.Path]::PathSeparator |
          Where-Object { $_ -and $_ -ne "$env:ChocolateyInstall\bin" }
  ) -join [System.IO.Path]::PathSeparator

  # NEVER use [Environment]::SetEnvironmentVariable() for PATH values; see https://github.com/dotnet/corefx/issues/36449
  # This issue exists in ALL released versions of .NET and .NET Core as of 12/19/2019
  $userKey.SetValue('PATH', $newUserPATH, 'ExpandString')
}

if ($machinePath -like "*$env:ChocolateyInstall*") {
  Write-Verbose "Chocolatey Install location found in Machine Path. Removing..."
  Write-Warning $warningMessage

  $newMachinePATH = @(
      $machinePath -split [System.IO.Path]::PathSeparator |
          Where-Object { $_ -and $_ -ne "$env:ChocolateyInstall\bin" }
  ) -join [System.IO.Path]::PathSeparator

  # NEVER use [Environment]::SetEnvironmentVariable() for PATH values; see https://github.com/dotnet/corefx/issues/36449
  # This issue exists in ALL released versions of .NET and .NET Core as of 12/19/2019
  $machineKey.SetValue('PATH', $newMachinePATH, 'ExpandString')
}

# Adapt for any services running in subfolders of ChocolateyInstall
$agentService = Get-Service -Name chocolatey-agent -ErrorAction SilentlyContinue
if ($agentService -and $agentService.Status -eq 'Running') {
  $agentService.Stop()
}
# TODO: add other services here

Remove-Item -Path $env:ChocolateyInstall -Recurse -Force -WhatIf

'ChocolateyInstall', 'ChocolateyLastPathUpdate' | ForEach-Object {
  foreach ($scope in 'User', 'Machine') {
    [Environment]::SetEnvironmentVariable($_, [string]::Empty, $scope)
  }
}

$machineKey.Close()
$userKey.Close()

• additionally

  if ($env:ChocolateyToolsLocation -and (Test-Path $env:ChocolateyToolsLocation)) {
    Remove-Item -Path $env:ChocolateyToolsLocation -WhatIf -Recurse -Force
  }
  
  foreach ($scope in 'User', 'Machine') {
    [Environment]::SetEnvironmentVariable('ChocolateyToolsLocation', [string]::Empty, $scope)
  }

packages

• example

  > choco install puppet-agent.portable -y
  > choco install ruby.portable -y
  > choco install git.commandline -y
  
  # pick an editor
  > choco install visualstudiocode.portable -y                      # not yet available
  > choco install notepadplusplus.commandline -y
  > choco install nano -y
  > choco install vim-tux.portable
  
  # What else can I install without admin rights?
  # https://community.chocolatey.org/packages?q=id%3Aportable

install

• sample log for lua

  [!NOTE|label:packages:]

  • vcredist2005 64 bit

  • vcredist2005 32 bit

  • lua 5.1.5-52

  > choco install lua
  Chocolatey v2.3.0
  Installing the following packages:
  lua
  By installing, you accept licenses for the packages.
  Downloading package from source 'https://community.chocolatey.org/api/v2/'
  Progress: Downloading vcredist2005 8.0.50727.619501... 100%
  
  vcredist2005 v8.0.50727.619501 [Approved]
  vcredist2005 package files install completed. Performing other installation steps.
  Downloading vcredist2005 64 bit
    from 'https://download.microsoft.com/download/8/B/4/8B42259F-5D70-43F4-AC2E-4B208FD8D66A/vcredist_x64.EXE'
  Progress: 100% - Completed download of C:\Users\marslo\AppData\Local\Temp\chocolatey\vcredist2005\8.0.50727.619501\vcredist_x64.EXE (3.03 MB).
  Download of vcredist_x64.EXE (3.03 MB) completed.
  Hashes match.
  Installing vcredist2005...
  vcredist2005 has been installed.
  Downloading vcredist2005 32 bit
    from 'https://download.microsoft.com/download/8/B/4/8B42259F-5D70-43F4-AC2E-4B208FD8D66A/vcredist_x86.EXE'
  Progress: 100% - Completed download of C:\Users\marslo\AppData\Local\Temp\chocolatey\vcredist2005\8.0.50727.619501\vcredist_x86.EXE (2.58 MB).
  Download of vcredist_x86.EXE (2.58 MB) completed.
  Hashes match.
  Installing vcredist2005...
  vcredist2005 has been installed.
    vcredist2005 may be able to be automatically uninstalled.
   The install of vcredist2005 was successful.
    Software installed as 'exe', install location is likely default.
  Downloading package from source 'https://community.chocolatey.org/api/v2/'
  Progress: Downloading Lua 5.1.5.52... 100%
  
  lua v5.1.5.52 [Approved]
  lua package files install completed. Performing other installation steps.
  Downloading lua
    from 'https://github.com/rjpcomputing/luaforwindows/releases/download/v5.1.5-52/LuaForWindows_v5.1.5-52.exe'
  Progress: 100% - Completed download of C:\Users\marslo\AppData\Local\Temp\chocolatey\Lua\5.1.5.52\LuaForWindows_v5.1.5-52.exe (27.8 MB).
  Download of LuaForWindows_v5.1.5-52.exe (27.8 MB) completed.
  Hashes match.
  Installing lua...
  lua has been installed.
    lua can be automatically uninstalled.
  Environment Vars (like PATH) have changed. Close/reopen your shell to
   see the changes (or in powershell/cmd.exe just type `refreshenv`).
   The install of lua was successful.
    Deployed to 'C:\Program Files (x86)\Lua\5.1\'
  
  Chocolatey installed 2/2 packages.
   See the log for details (C:\ProgramData\chocolatey\logs\chocolatey.log).

• sample output for lua53

  > choco install lua53
  Chocolatey v2.2.2
  Installing the following packages:
  lua53
  By installing, you accept licenses for the packages.
  Progress: Downloading lua53 5.3.5... 100%
  
  lua53 v5.3.5 [Approved]
  lua53 package files install completed. Performing other installation steps.
  WARNING: Url has SSL/TLS available, switching to HTTPS for download
  Downloading lua53 64 bit
    from 'https://sourceforge.net/projects/luabinaries/files/5.3.5/Tools%20Executables/lua-5.3.5_Win64_bin.zip/download'
  Progress: 100% - Completed download of C:\Users\marslo\AppData\Local\Temp\chocolatey\lua53\5.3.5\lua53Install.zip (336.43 KB).
  Download of lua53Install.zip (336.43 KB) completed.
  Hashes match.
  Extracting C:\Users\marslo\AppData\Local\Temp\chocolatey\lua53\5.3.5\lua53Install.zip to C:\ProgramData\chocolatey\lib\lua53\tools...
  C:\ProgramData\chocolatey\lib\lua53\tools
  PATH environment variable does not have C:\ProgramData\chocolatey\lib\lua53\tools in it. Adding...
  Environment Vars (like PATH) have changed. Close/reopen your shell to
   see the changes (or in powershell/cmd.exe just type `refreshenv`).
   The install of lua53 was successful.
    Software installed to 'C:\ProgramData\chocolatey\lib\lua53\tools'
  
  Chocolatey installed 1/1 packages.
   See the log for details (C:\ProgramData\chocolatey\logs\chocolatey.log).

upgrade

• list outdated packages

  > choco outdated
  Chocolatey v2.2.2
  Outdated Packages
   Output is package name | current version | available version | pinned?
  
  chocolatey|2.2.2|2.3.0|false
  Everything|1.4.11024|1.4.11026|false
  fd|9.0.0|10.1.0|false
  fzf|0.46.1|0.53.0|false
  go|1.22.0|1.23.0|false
  golang|1.22.0|1.23.0|false
  microsoft-windows-terminal|1.19.10302|1.20.11781|false
  neovim|0.9.5|0.10.1|false
  python|3.12.2|3.12.5|false
  python3|3.12.2|3.12.5|false
  python312|3.12.2|3.12.5|false
  vcredist140|14.38.33135|14.40.33810|false
  
  Chocolatey has determined 12 package(s) are outdated.

• upgrade all outdated packages

  > choco upgrade all -y
  ...
  ...
  Upgraded:
   - chocolatey v2.3.0
   - Everything v1.4.11026
   - fd v10.1.0
   - fzf v0.53.0
   - go v1.23.0
   - golang v1.23.0
   - microsoft-windows-terminal v1.20.11781
   - python v3.12.5
   - python3 v3.12.5
   - python312 v3.12.5
   - vcredist140 v14.40.33810
  
  Failures
   - neovim (exited 2) - Error while running 'C:\ProgramData\chocolatey\lib\neovim\tools\chocolateyinstall.ps1'.
   See log for details.

config

list

> choco config list
Chocolatey v2.2.2
cacheLocation =  | Cache location if not TEMP folder. Replaces `$env:TEMP` value for choco.exe process. It is highly recommended this be set to make Chocolatey more deterministic in cleanup.
commandExecutionTimeoutSeconds = 2700 | Default timeout for command execution. '0' for infinite.
containsLegacyPackageInstalls = true |
defaultPushSource =  | Default source to push packages to when running 'choco push' command.
defaultTemplateName =  | Default template name used when running 'choco new' command.
proxy = http://ipamunix.sample.com:8080 | Explicit proxy location.
proxyBypassList =  | Optional proxy bypass list. Comma separated.
proxyBypassOnLocal = true | Bypass proxy for local connections.
proxyPassword =  | Optional proxy password. Encrypted.
proxyUser =  | Optional proxy user.
upgradeAllExceptions =  | A comma-separated list of package names that should not be upgraded when running `choco upgrade all'. Defaults to empty.
webRequestTimeoutSeconds = 30 | Default timeout for web requests.

proxy

[!NOTE|label:references:]

• Use Chocolatey w/Proxy Server

• setup in config

  > choco config set --name="'proxy'" --value="'http://ipamunix.sample.com:8080'"
  
  # optioanl
  > choco config set --name="'proxyUser'"          --value="'<USERNAME>'"
  > choco config set --name="'proxyPassword'"      --value="'<PASSWORD>'"
  > choco config set --name="'proxyBypassList'"    --value="'http://localhost,http://this.location/'"
  > choco config set --name="'proxyBypassOnLocal'" --value="'true'"

• using at runtime

  > choco install <package> --proxy="'http://ipamunix.sample.com:8080'"
  
  # full format
  > choco install <package> --proxy="'http://ipamunix.sample.com:8080'",
                            --proxy-user="'<user>'",
                            --proxy-password="'<pwd>'",
                            --proxy-bypass-list="'<REGEX-BYPASS-LIST-COMMA-SEPARATED>'",
                            --proxy-bypass-on-local

• unset

  > choco config unset proxy

others

• update help

  > Get-Help Get-ToolsLocation -Full
  
  Do you want to run Update-Help?
  The Update-Help cmdlet downloads the most current Help files for Windows PowerShell modules, and installs them on your
  computer. For more information about the Update-Help cmdlet, see https:/go.microsoft.com/fwlink/?LinkId=210614.
  [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y