Boxstarter
BoxStarter box scripts
Install / Use
/learn @JonCubed/BoxstarterREADME
Automated Windows PC Setup
A script for setting up a Windows PC using BoxStarter and Chocolatey.
This script is based on my original gist and neutmute script's
How To Use
There are a few options for launching a BoxStarter script check out the offical documentation for all the various methods. We'll focus on two methods - manual and bootstrapper.
Bootstrapper
The Bootstrapper method is the recommended way to run this script. Simply open a evelated powershell console and run the following command
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" <arguments> }
You can remove <arguments> or replace it with one or more argument lists below
|Argument|Type|Requires|Value Description|
|--------|----|--------|-----------------|
|InstallDev|Switch||Configures machine for development and install development apps|
|InstallHome|Switch||Configures machine for home and install home apps|
|SkipWindowsUpdate|Switch||Skips running windows update|
|DataDrive|Char||Drive letter to move data too. Defaults to System Drive|
|SourceCodeFolder|String|InstallDev|Relative or Absolute path to source code folder. If relative will use Data Drive value (default value /sourcecode|
|EnableWindowsAuthFeature|Switch|InstallDev|Enable Windows Authentication in IIS|
|InstallVS2017Community|Switch|InstallDev|Install Visual Studio 2017 Community edition|
|InstallVS2017Enterprise|Switch|InstallDev|Install Visual Studio 2017 Enterprise edition|
|CustomiseFolders|Switch||Customise Folder locations and disk names|
|SqlServer2016IsoImage|String|InstallDev|Absolute path to Sql Server 2016 ISO|
|SqlServer2014IsoImage|String|InstallDev|Absolute path to Sql Server 2014 ISO|
Examples
-
Setup a development box without windows update
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" -InstallDev -InstallVS2017Enterprise -SkipWindowsUpdate } -
Setup a development box, move windows libraries and source code folder to another drive
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" -InstallDev -InstallVS2017Community -CustomiseFolders -DataDrive 'D' -SourceCodeFolder '/source' } -
Setup a development box with sql server 2016
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" -InstallDev -InstallVS2017Enterprise -SqlServer2016IsoImage 'D:/temp/en_sql_server_2016_developer_x64_dvd_8777069.iso' } -
Setup a development box with sql server 2014
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" -InstallDev -InstallVS2017Community -SqlServer2014IsoImage 'D:/temp/en_sql_server_2014_developer_x64_dvd_8777069.iso' } -
Setup a home box
wget -Uri 'https://raw.githubusercontent.com/JonCubed/boxstarter/master/bootstrap.ps1' -OutFile "$($env:temp)\bootstrap.ps1";&Invoke-Command -ScriptBlock { &"$($env:temp)\bootstrap.ps1" -InstallHome }
Manual
If you want more control over what is happening you can manually run the script.
-
You must first setup environment keys for the features you would like to install.
|Key|Value|Requires|Value Description| |--------|----|--------|-----------------| |BoxStarter:InstallDev|1||Configures machine for development and install development apps| |BoxStarter:InstallHome|1||Configures machine for home and install home apps| |BoxStarter:SkipWindowsUpdate|1||Skips running windows update| |BoxStarter:DataDrive|Char||Drive letter to move data too. Defaults to System Drive| |BoxStarter:SourceCodeFolder|String|BoxStarter:InstallDev|Relative or Absolute path to source code folder. If relative will use Data Drive value| |BoxStarter:EnableWindowsAuthFeature|1|BoxStarter:InstallDev|Enable Windows Authentication in IIS| |BoxStarter:CustomiseFolders|1||Customise Folder locations and disk names| |BoxStarter:InstallVS2017Community|1|Install Visual Studio 2017 Community edition| |BoxStarter:InstallVS2017Enterprise|1|Install Visual Studio 2017 Enterprise edition| |choco:sqlserver2016:isoImage|String|BoxStarter:InstallDev|Absolute path to Sql Server 2016 ISO| |choco:sqlserver2014:isoImage|String|BoxStarter:InstallDev|Absolute path to Sql Server 2014 ISO|
Environment variables must be added to Machine and Process scopes
-
Run the following command
- In Command prompt or Powershell
START http://boxstarter.org/package/nr/url?http://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/JonCubed/boxstarter/master/box.ps1
-
In Edge Or Internet Explorer, go to
http://boxstarter.org/package/nr/url?http://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/JonCubed/boxstarter/master/box.ps1
