endjin-workstation-setup

This repository helps you setup your development workstation and provides an ongoing mechanism for managing the software you need.

It targets two core scenarios:

1. Using an Azure virtual machine - go here to get started
2. Using an existing Windows system you already have access to (e.g. a new laptop) - go here to get started

The intention is that you fork this repo into your own GitHub account and customise the configuration as required - this repo will then provide you with a mechanism to rapidly get yourself up-and-running in the event of using a new machine or after fresh install of Windows on your existing machine.

Using an Existing Windows Machine

If you already have a suitable Windows machine, then check whether you have the following pre-requisites already available:

PowerShell Core

• You can do this by downloading and running the MSI installer for PowerShell Core from GitHub.

• Use all of the default settings when the installer runs.

Chocolatey

• Chocolatey is a tool for installing software onto Windows. It takes care of a lot of the pain in installing software.

• To install, follow the instructions at Installing Chocolatey .

Use Chocolatey to install Git:

`choco install -y git`

Installing Windows Subsystem for Linux (aka WSL)

For the moment the most reliable way to install Windows Subsystem for Linux is to follow the manual process documented here

Managing your installed software

1. If you haven't already done so, fork this repository into your own GitHub account via the 'Fork' option in the top right of this page you are reading
2. Create a directory where you will store all the git repositories you work with (e.g. C:\code)
3. Open a new elevated 'Windows PowerShell' terminal from the Start Menu (Run as Administrator)
4. cd into the folder you created above
5. Clone this repository to your machine: git clone https://github.com/<your-github-username>/endjin-workstation-setup.git
6. cd into endjin-workstation-setup directory created by the above command
7. Review the setup-chocolatey-packages.config file, adding any further packages you require - they can be found by searching here
8. Run ./setup.ps1 to begin the software install process
9. Commit any changes you made to the above files and push them up to GitHub so they are safely stored