Skip to content
Repeatable, reboot resilient windows environment installations made easy using Chocolatey packages
PowerShell Python HTML Other
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github (doc) Update template May 10, 2020
.vscode (vscode) Added exclusion for buildArtifacts folder May 14, 2018
BoxStarter.Common (maint) PoSh verb casing Dec 2, 2018
Boxstarter.Azure (maint) PoSh verb casing Dec 2, 2018
Boxstarter.Bootstrapper GH-402 pr review Feb 23, 2020
Boxstarter.Chocolatey Merge pull request #402 from mwallner/feature/ExitOnFirstError Feb 26, 2020
Boxstarter.ClickOnce (release v2.12.0) Updated version numbers Oct 30, 2018
Boxstarter.HyperV (maint) PoSh verb casing Dec 2, 2018
Boxstarter.TestRunner (maint) PoSh verb casing Dec 2, 2018
Boxstarter.WinConfig (GH-399) Update new function name Jan 28, 2020
BuildPackages fixed spelling of write- to Write- Nov 24, 2018
BuildScripts (GH-420) Enable TLS 1.2 Feb 5, 2020
IntegrationTests (maint) PoSh verb casing Dec 2, 2018
Web (GH-428) Add Veeam blog posts May 6, 2020
tests (maint) PoSh verb casing Dec 2, 2018
.appveyor.yml (build) Switch to doing a quick-deploy May 11, 2018
.editorconfig GH-347 rev changes Jun 4, 2019
.gitignore (GH-362) Fix publishing of Web Site Oct 30, 2018
BoxStarter.bat (maint) Corrected whitespace May 11, 2018
Boxstarter.sln included .editorconfig in VS sln Dec 15, 2018
BoxstarterShell.ps1 (doc) chocolatey -> Chocolatey May 14, 2018
COMMITTERS.md Fix typo Nov 6, 2019
CONTRIBUTING.md Add style coding guidelines (#408) Oct 9, 2019
GitReleaseManager.yaml (build) Add GitReleaseManager.yaml file Oct 30, 2018
LICENSE.txt (GH-106) SSL all the things May 8, 2018
NOTICE.txt (license) Corrected year May 11, 2018
README.md (GH-333) Fix docs (#335) Aug 13, 2018
Vagrantfile add a Vagrantfile Feb 18, 2015
boxlogo.ico added a boxstarter shell for loading modules Jan 9, 2014
boxstarter.config (doc) Updated to remove MyGet references May 14, 2018
build.bat (maint) Corrected whitespace May 11, 2018
deployment.md (#321) Added VS requirements Jul 23, 2018
test_marker updating choco dll and fixing tests Jul 21, 2016
vNext.md (doc) powershell -> PowerShell May 14, 2018

README.md

Boxstarter

Repeatable, reboot resilient windows environment installations made easy using Chocolatey packages

For more information and How Tos, visit the official Boxstarter website

Windows environment creation made easy!

  • 100% Unattended Install with pending reboot detection and automatic logon.
  • Remote machine deployments
  • Integrates with Hyper-V and Windows Azure VMs supporting checkpoint restore and creation
  • Installation packages build on top of Chocolatey package management
  • Easily install with just a Gist and the Boxstarter Web Launcher or create a private repository on a thumb drive or network share
  • Works on Window 7/2008 R2 and up with PowerShell 2.0 and higher
  • Lots of Windows configuration utilities including installing critical updates, changing windows explorer options, and more.

Quickly install your favorite applications and settings, on any machine, with a gist! No pre-installed software needed.

Grab your Gist

gist

Launch the Boxstarter launcher

boxstarter weblauncher

Easily package installation scripts and resources in a NuGet package

A simple Hello World

Import-Module Boxstarter.Chocolatey
New-BoxstarterPackage HelloWorld
Set-Content (Join-Path $Boxstarter.LocalRepo "HelloWorld\Tools\ChocolateyInstall.ps1") `
  -Value "Write-Host `"Hello World! from `$env:COMPUTERNAME`";CINST Git" -Force
Invoke-BoxstarterBuild HelloWorld

Install on another machine

$creds=Get-Credential win7\mwrock
Install-BoxstarterPackage -ComputerName win7 `
  -Package HelloWorld -Credential $creds

Remote Install

NOTE: PowerShell Remoting must be enabled on the remote machine. Launch a PowerShell Console as administrator:

Enable-PSRemoting -Force

Information

Documentation

Please see the Boxstarter docs.

Requirements

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

License / Credits

Apache 2.0 - see LICENSE and NOTICE files.

Etiquette Regarding Communication

If you are an open source user requesting support, please remember that most folks in the Chocolatey community are volunteers that have lives outside of open source and are not paid to ensure things work for you, so please be considerate of others' time when you are asking for things. Many of us have families that also need time as well and only have so much time to give on a daily basis. A little consideration and patience can go a long way. After all, you are using a pretty good tool without cost. It may not be perfect (yet), and we know that.

Submitting Issues

submitting issues

Observe the following help for submitting an issue:

Prerequisites:

  • The issue has to do with Boxstarter itself or the Boxstarter website and is not a Chocolatey package issue.
  • Please check to see if your issue already exists with a quick search of the issues. Start with one relevant term and then add if you get too many results.
  • You are not submitting an "Enhancement". Enhancements should observe CONTRIBUTING guidelines.
  • You are not submitting a question - questions are better served as emails or Gitter chat questions.
  • Please make sure you've read over and agree with the etiquette regarding communication.

Submitting a ticket:

  • We'll need debug and verbose output, so please run and capture the log with -Debug -Verbose (ie. Install-Boxstarter -PackageName <PACKAGE NAME OR GIST> -Verbose -Debug. If it is less than 50 lines you can submit that with the issue or if it is longer, create a gist and link it.
  • Please note that the debug/verbose output for some commands may have sensitive data (passwords or API Keys) related so please remove those if they are there prior to submitting the issue.
  • If your issue needs output from choco.exe, then it logs to a file in $env:ChocolateyInstall\log\. You can grab the specific log output from there so you don't have to capture or redirect screen output. Please limit the amount included to just the command run (the log is appended to with every command).
  • Please save the log output in a gist (save the file as log.sh) and link to the gist from the issue. Feel free to create it as secret so it doesn't fill up against your public gists. Anyone with a direct link can still get to secret gists. If you accidentally include secret information in your gist, please delete it and create a new one (gist history can be seen by anyone) and update the link in the ticket (issue history is not retained except by email - deleting the gist ensures that no one can get to it). Using gists this way also keeps accidental secrets from being shared in the ticket in the first place as well.
  • We'll need the entire log output from the run, so please don't limit it down to areas you feel are relevant. You may miss some important details we'll need to know. This will help expedite issue triage.
  • It's helpful to include the version of Boxstarter, the version of the OS, whether running on physical or virtual hardware and the version of PowerShell - the debug script should capture all of those pieces of information.
  • Include screenshots and / or animated gifs whenever possible as they help show us exactly what the problem is.

Contributing

If you would like to contribute code or help squash a bug or two, that's awesome. Please familiarize yourself with CONTRIBUTING.

Committers

Committers, you should be very familiar with COMMITTERS.

You can’t perform that action at this time.