About Chocolatey
What is Chocolatey?
Chocolatey is a free, open-source package manager for Windows. It works like apt on Linux or Homebrew on macOS, letting you install, update, and manage software from the command line. Instead of downloading installers from the web and clicking through setup wizards, you run a single command like choco install googlechrome and Chocolatey handles the rest.
Learn more at chocolatey.org.
Is Chocolatey safe to use?
Yes, Chocolatey is widely trusted in the Windows ecosystem and is used by individual developers, IT teams, and enterprises around the world. Packages in the Chocolatey Community Repository go through a moderation process that includes automated checks and human review.
As with any package manager, you should always review what you install and prefer packages from trusted maintainers with high download counts.
What is the difference between choco install and choco upgrade?
choco install is used to install a package for the first time. choco upgrade updates an already-installed package to the latest version. You can also run choco upgrade all to update every installed package at once, which is exactly what the auto-update script automates.
If you run choco install on a package that is already installed, Chocolatey will tell you the package is already present and take no action.
What versions of Windows are supported?
Chocolatey itself supports Windows 7 and later, but these scripts are designed for and tested on Windows 10 and Windows 11. You need PowerShell 5.1 or later (included with Windows 10/11) and administrator privileges to run the scripts.
PowerShell 7+ is recommended for the best experience but is not required.
About These Scripts
Are these scripts safe to run on my computer?
The scripts are fully open-source and every line of code is available for review on GitHub. They include safety features like confirmation prompts, dry-run modes, and detailed logging.
That said, they do modify system settings (execution policies, scheduled tasks, installed software), so you should always read through a script before running it with administrator privileges. See our Safety & Best Practices guide for more details.
What does the validate-setup script do?
The validate-setup.ps1 script checks that Chocolatey is properly installed, verifies that all expected scripts are present, confirms scheduled tasks are configured correctly, and ensures the environment is ready for automated maintenance.
Think of it as a pre-flight checklist for your entire setup. It reports any issues it finds so you can fix them before they cause problems.
Can I customize which apps get installed?
Yes. The install-essential-apps.ps1 script reads from a configurable list of packages. You can edit the script or the associated configuration to add, remove, or change which applications are installed. The script is designed to be easily customizable.
Browse the Chocolatey package directory to find package names for software you want to include.
Do the scripts work on both Windows 10 and Windows 11?
Yes. All scripts are tested on both Windows 10 and Windows 11. Features like toast notifications use the Windows notification system that is available on both operating systems. The scheduled tasks functionality also works identically on both versions.
What happens if a script fails partway through?
Each script includes error handling and logging. If something goes wrong, the script writes details to a log file in your %USERPROFILE%\Logs directory. Most scripts are designed to be safe to re-run — they pick up where they left off or skip steps that are already complete.
Check the log file for the specific error message. If you need help, you can open an issue on GitHub with the relevant log output.
Troubleshooting
I get an execution policy error when running a script. How do I fix it?
Open PowerShell as Administrator and run:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
This allows locally-created scripts to run while still blocking unsigned scripts downloaded from the internet. You only need to do this once. If you are in an enterprise environment, your IT administrator may manage execution policies via Group Policy.
Chocolatey is not found after running the install script. What should I do?
Close and reopen your PowerShell window (or terminal) after installation. Chocolatey adds itself to the system PATH, but existing sessions may not pick up the change until they are restarted.
If the problem persists, verify that C:\ProgramData\chocolatey\bin is in your PATH environment variable. You can check by running $env:PATH -split ';' in PowerShell and looking for the Chocolatey path in the output.
A package fails to install. What can I try?
First, make sure you are running PowerShell as Administrator. Then try running choco install <package> --force to retry the installation. If it still fails, check the Chocolatey log at C:\ProgramData\chocolatey\logs\chocolatey.log for detailed error messages.
Common causes include network issues, insufficient disk space, or the package being temporarily unavailable from the repository. You can also try choco install <package> --force --ignore-checksums as a last resort, though this bypasses an important security check.
The auto-update script says WiFi is not detected. Why?
The auto-update script checks for a WiFi connection before downloading updates to avoid using metered or cellular connections. If you are on a wired Ethernet connection, the script may not detect it as WiFi and will skip the update.
You can modify the connectivity check in the script to also allow Ethernet connections, or bypass the check entirely if you know your connection is suitable for downloading updates.
How do I stop or remove a scheduled task created by the scripts?
Open Task Scheduler (search for it in the Start menu), navigate to the task under the Chocolatey Scripts folder, right-click it, and choose Disable or Delete.
You can also use PowerShell:
Unregister-ScheduledTask -TaskName "TaskName" -Confirm:$false
The setup-scheduled-tasks.ps1 script documents the exact task names it creates, so you know which tasks to look for.