Step-by-Step Guide: Install Chocolatey on Windows

Posted on by

Are you tired of manually downloading, clicking through installers, and updating software on your Windows machine? There’s a better way! Chocolatey is a command-line package manager for Windows that automates these tasks, making software installation and management incredibly efficient. Think of it like apt-get or yum for Linux, but for Windows.

If you’re new to Chocolatey and want to understand its benefits, check out our article: What is Chocolatey and Why Use It?. But if you’re ready to dive in and start automating your software workflow, this guide will walk you through exactly how to Install Chocolatey on Windows, step-by-step. It’s a straightforward process, and by following these instructions carefully, you’ll have Choco up and running in no time.

Before You Begin: Prerequisites

Before you start the Chocolatey installation process, make sure your system meets these basic requirements:

  • Operating System: Windows 7+ (or Windows Server 2003+). This includes modern versions like Chocolatey Windows 10 and Chocolatey Windows 11.
  • Command Line Interface: Either PowerShell (version 2+) or Command Prompt (cmd.exe). PowerShell is generally recommended for a smoother experience, especially regarding execution policy.
  • .NET Framework: Version 4.5 or later. This is usually pre-installed on modern Windows versions (Windows 8+).
  • Administrator Privileges: This is crucial! The installation script needs to make system-level changes, such as setting environment variables and potentially modifying system files. You must run the installation commands from an elevated prompt.

Ensuring you have administrator privileges is the most common hurdle, so pay close attention to the next step.

Step 1: Open PowerShell/CMD as Administrator

The very first step in setting up Chocolatey is opening your chosen command-line tool with the necessary permissions. This means running it as an Administrator.

Here’s how to do it:

  1. Click the Windows Start button.
  2. Type “PowerShell” or “Command Prompt” in the search bar.
  3. Right-click on the search result (either “Windows PowerShell” or “Command Prompt”).
  4. Select “Run as administrator” from the context menu.

You might see a User Account Control (UAC) prompt asking for permission; click “Yes”. To verify you are running with Administrator privileges, look at the title bar of the window that opens. It should clearly say “Administrator: Windows PowerShell” or “Administrator: Command Prompt”.

Using an elevated prompt is essential for the Chocolatey installation guide to work correctly, as it allows the script to modify system settings required for the choco command to be available globally.

Step 2: Set the Execution Policy

Windows uses a security feature called Execution Policy to control which PowerShell scripts are allowed to run on your system. By default, the policy might prevent the Chocolatey installation script from executing. We need to temporarily adjust this policy.

First, you can check your current Execution Policy by running this command:

Get-ExecutionPolicy

Press Enter. If the output is “Restricted” or “Default”, you will likely need to change it.

To allow the installation script to run, you need to set the policy. Chocolatey recommends using one of the following methods for the Chocolatey command line install:

Option A (Recommended – Temporary & Safe): Set the policy to `Bypass` specifically for the current process. This is the most secure method as it only affects the current PowerShell window and reverts when the window is closed.

Set-ExecutionPolicy Bypass -Scope Process

Option B (Also Secure – Requires Signing): Set the policy to `AllSigned`. This allows scripts that have been digitally signed by a trusted publisher. The official Chocolatey script is signed.

Set-ExecutionPolicy AllSigned

If you choose Option B and are prompted whether you want to change the execution policy, type ‘A’ and press Enter to confirm for all applicable scopes.

Important Note: While other policies like `Unrestricted` exist, they are less secure as they allow any script to run. The `Bypass -Scope Process` method is ideal for simple installations like this as it’s temporary and minimal risk. The `AllSigned` method is also secure as it relies on trusted publishers.

Step 3: Execute the Chocolatey Installation Script

With your terminal open as Administrator and the Execution Policy set appropriately, you are ready to run the official Install Chocolatey script. This script handles downloading the necessary files, setting up environment variables, and configuring Chocolatey on your system.

It’s highly recommended to get the latest installation command directly from the official Chocolatey website (link to official Chocolatey site – Installation page), as it can sometimes change. However, at the time of writing, these are the standard commands:

For PowerShell:

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'))

For Command Prompt (cmd.exe):

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

Copy the command for your chosen terminal (PowerShell is recommended) and paste it into the Administrator window you opened in Step 1. Press Enter to execute it.

The script will download and install Chocolatey. This may take a few moments, and you will see output indicating the progress. Wait until the script finishes running and you see the command prompt return.

Step 4: Verify Your Installation

Once the script has completed, you need to confirm that Chocolatey was installed successfully and that the choco command is recognized by your system. You can do this by running a simple command.

In the same Administrator terminal window, type:

choco

Or, for more detailed output:

choco -?

Or specifically check the version:

choco version

If the installation was successful, you will see output displaying Chocolatey’s version information and command usage details. This confirms that the Chocolatey installation guide steps worked and the environment variables were set correctly.

Important Note: If you run the verification command in the *same* terminal window used for installation and it says `choco` is not recognized, this is usually because the environment variables haven’t refreshed for that specific window. Simply close the Administrator terminal window and open a *new* one (again, making sure to run it as Administrator). The `choco` command should now work in the new window.

What’s Next? Installing Your First Package

Congratulations! You have successfully completed the Setup Chocolatey Windows process. Now for the fun part – installing software with a single command!

The basic command to install a package is:

choco install [package name]

For example, to install VLC Media Player, you would simply type:

choco install vlc

Chocolatey will find the package in the Chocolatey Community Repository, download it, and run the installer for you, often silently!

You can find a vast list of available packages on the official Chocolatey website. Explore the repository and start automating your software installations today!

Troubleshooting Common Installation Issues

While the Chocolatey tutorial is designed to be simple, sometimes things don’t go perfectly. Here are a few common issues and their solutions:

  • ‘choco’ command not recognized after install: As noted in Step 4, this is usually due to environment variables not refreshing. Close the terminal and open a new one *as Administrator*.
  • Script blocked by Execution Policy: Did you perform Step 2 correctly? Ensure you opened the terminal as Administrator and ran `Set-ExecutionPolicy Bypass -Scope Process -Force` or `Set-ExecutionPolicy AllSigned`.
  • Permission Denied errors: This almost always means you did not open the terminal “Run as administrator”. Close it and reopen it with elevated privileges.
  • Installation fails mid-script: Check your internet connection. The script needs to download files from the internet. Proxy settings or firewalls can sometimes interfere.
  • Installation takes a long time or hangs: This could be due to slow internet or issues with the Chocolatey server. Sometimes retrying the command can help. Check the official Chocolatey status page if issues persist.

Most issues are related to not having Administrator privileges or the Execution Policy. Double-check those steps first when Troubleshooting installation.

Conclusion

You’ve done it! By following this step-by-step guide, you have successfully completed the process to How to install Chocolatey on your Windows machine. You now have a powerful package manager at your fingertips, ready to revolutionize how you manage software.

From installing new applications to updating existing ones, the simple `choco` commands will save you significant time and effort. Start exploring the Chocolatey Community Repository and experience the ease of command-line software management on Windows!