Installing Boxstarter

Boxstarter can be installed using Chocolatey or by downloading the Boxstarter zip file and running Setup.Bat


Boxstarter requires the following to work:

  • OS: Windows 7 or Windows Server 2008 R2 and higher
  • PowerShell Version 2 or higher
  • Administrative privileges on the machine where Boxstarter is running

Installing from Chocolatey

CINST Boxstarter

This will download and install the Boxstarter modules to your PSModulePath.

Downloading the zip file

The zip file contains a Setup.Bat file that will go to Chocolatey and install Boxstarter. If Chocolatey is not installed on your machine, the Boxstarter installer will request the user's permission to install it. Note: Setup.bat accepts a -Force argument to suppress this prompt.

Boxstarter is now installed in your modules path!

Both the Chocolatey Boxstarter package and the downloaded zip file available on this website install all Boxstarter modules except the Boxstarter.Azure module which provides integration with Windows Azure VMs. You can install the Azure module by running CINST Boxstarter.Azure. In addition to the Boxstarter.Azure module, it also installs the Windows Azure PowerShell toolkit, the Azure SDK for .Net Libraries and .Net 4.5. It requires PowerShell 3 or higher (the version installed with Windows 8/server 2012 and higher but also freely available for download on older versions) to install successfully.

After Boxstarter is installed, a new PowerShell console must be opened before you can load the modules and run its commands. For convenience you can use the Boxstarter Shell for running Boxstarter commands which is the easiest way to ensure that all Boxstarter modules are properly loaded regardless of the version of Windows and PowerShell you are running.

Installing from the web

Run the following command from PowerShell:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('')); Get-Boxstarter -Force

Uninstalling Boxstarter

If you need to remove Boxstarter from your system, run code below in a PowerShell console:

# Remove the Chocolatey packages in a specific order!
'Boxstarter.Azure', 'Boxstarter.TestRunner', 'Boxstarter.WindowsUpdate', 'Boxstarter',
    'Boxstarter.HyperV', 'Boxstarter.Chocolatey', 'Boxstarter.Bootstrapper', 'Boxstarter.WinConfig', 'BoxStarter.Common' |
    ForEach-Object { choco uninstall $_ -y }

# Remove the Boxstarter data folder
Remove-Item -Path (Join-Path -Path $env:ProgramData -ChildPath 'Boxstarter') -Recurse -Force

# Remove Boxstarter from the path in both the current session and the system
$env:PATH = ($env:PATH -split ';' | Where-Object { $_ -notlike '*Boxstarter*' }) -join ';'
[Environment]::SetEnvironmentVariable('PATH', $env:PATH, 'Machine')

# Remove Boxstarter from the PSModulePath in both the current session and the system
$env:PSModulePath = ($env:PSModulePath -split ';' | Where-Object { $_ -notlike '*Boxstarter*' }) -join ';'
[Environment]::SetEnvironmentVariable('PSModulePath', $env:PSModulePath, 'Machine')
Boxstarter installs [Chocolatey]( and this needs to be [uninstalled]( separately.