mwguerra / windows-setup

Steps to reproduce the initial setup of a Windows backup development notebook (WSL - Ubuntu, Hyper, NodeJS and Laravel Homestead)

windows-setup

Steps to reproduce the initial setup of a Windows backup development notebook.

• Update Windows

• Install Google Chrome

• Install Visual Studio Code

• Install GitHub Desktop

• Install Oracle Virtual Box

• Install Hyper Terminal

• Install Windows Terminal (https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?activetab=pivot:overviewtab)

• Setup Windows developer mode and turn on the Windows Subsystem for Linux (WSL) feature

• Install Ubuntu from the Windows Store and run/install it

• Windows path to the WSL Ubuntu root

%LOCALAPPDATA%\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState\rootfs

or, to find it out from the WSL terminal, call explorer.exe from your home directory

explorer.exe .

Update Windows

• You must have Windows Pro in order to install the developer tools
• Make sure you have version 2004 or higher (https://www.microsoft.com/software-download/windows10)
• At the "Windows Features" window, enable HyperV, Virtual Machine Platform and Windows Subsystem for Linux
• Install WSL version 2 (https://docs.microsoft.com/en-us/windows/wsl/install-win10#update-to-wsl-2)

Hyper Terminal

• After installation set each shortcut to always run as administrator (properties->shortcut->advanced->runAsAdministrator)
• Open the bash prompt
• Install Zsh and Oh My Zsh

sudo apt install zsh

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

• Download the Spaceship theme for Zsh:

git clone https://github.com/denysdovhan/spaceship-prompt.git "$ZSH_CUSTOM/themes/spaceship-prompt"

ln -s "$ZSH_CUSTOM/themes/spaceship-prompt/spaceship.zsh-theme" "$ZSH_CUSTOM/themes/spaceship.zsh-theme"

• Setup Zsh to be called automatically by Bash. Edit the ~/.bashrc file and append to the file:

cd ~
bash -c zsh
exit

• Paste the lines below at the end of the ~/.zshrc file:

export PATH="$PATH:/mnt/c/Program Files/Oracle/VirtualBox"
export PATH=$PATH:~/.config/composer/vendor/bin
export VAGRANT_WSL_ENABLE_WINDOWS_ACCESS="1"

ZSH_THEME="spaceship"
SPACESHIP_PROMPT_ORDER=(
  user          # Username section  
  dir           # Current directory section  
  host          # Hostname section  
  git           # Git section (git_branch + git_status)  
  hg            # Mercurial section (hg_branch + hg_status)
  exec_time     # Execution time
  line_sep      # Line break
  vi_mode       # Vi-mode indicator
  jobs          # Background jobs indicator
  exit_code     # Exit code section
  char          # Prompt character
)
SPACESHIP_USER_SHOW=always
SPACESHIP_PROMPT_ADD_NEWLINE=false
SPACESHIP_CHAR_SYMBOL="❯"
SPACESHIP_CHAR_SUFFIX=" "

# Simplify prompt if we're using Hyper (MacOS Only)
# if [[ "$TERM_PROGRAM" == "Hyper" ]]; then
#   SPACESHIP_PROMPT_SEPARATE_LINE=false
#   SPACESHIP_DIR_SHOW=false
#   SPACESHIP_GIT_BRANCH_SHOW=false
# fi

function homestead() {
    ( cd /mnt/c/Users/[yourusername]/Homestead && vagrant $* )
}

source $ZSH/oh-my-zsh.sh
source ~/.zsh-nvm/zsh-nvm.plugin.zsh

alias ll='ls -alFh'
alias dev='cd /mnt/c/Users/[yourusername]/Documents/code' # 'code' was reserved to the VSCode WSL extension

• Download the Fira Code fonts at https://github.com/tonsky/FiraCode. Unzip and double click the TTF to install.

• Open the Hyper config file (CTRL+',') and change the default shell to be bash and the font family (just add "Fira Code" before Menlo):

shell: 'C:\\Windows\\System32\\bash.exe'
fontFamily: '"Fira Code", Menlo, ...

Update packages and upgrade the WSL Ubuntu

sudo apt-get update
sudo apt-get upgrade
sudo -S apt-mark hold procps strace sudo
sudo -S env RELEASE_UPGRADER_NO_SCREEN=1 do-release-upgrade

Install PHP, MySQL, Composer, NVM, Node, Yarn, Typescript and Vagrant

• PHP & MySQL Installation

sudo apt-get update
sudo apt -y install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt install -y php7.4
sudo apt install -y php7.4-{bcmath,bz2,intl,gd,mbstring,mysql,zip,dom}
sudo apt install -y php-{redis,xdebug,mysql}
sudo apt install -y mysql-server
php -m

• Composer Installation

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

• Laravel Installer Installation

sudo apt-get install unzip
composer global require laravel/installer

• NVM and NodeJS Installation

git clone https://github.com/lukechilds/zsh-nvm.git ~/.zsh-nvm
source ~/.zsh-nvm/zsh-nvm.plugin.zsh
nvm install --lts

• Yarn Installation (without Node, since Node is being already handled by NVM)

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install --no-install-recommends yarn

In case of any problem have a look at this: yarnpkg/yarn#4453 (comment) and check if you have WSL2: https://docs.microsoft.com/en-us/windows/wsl/install-win10

• Vagrant and Homestead Installation

Install Vagrant for Windows 64 bits at the same version you will install on WSL

sudo apt update
curl https://releases.hashicorp.com/vagrant/2.2.9/vagrant_2.2.9_x86_64.deb -O
sudo dpkg -i vagrant_2.2.9_x86_64.deb
rm vagrant_2.2.9_x86_64.deb
vagrant -v
vagrant box add laravel/homestead
git clone https://github.com/laravel/homestead.git /mnt/c/Users/[yourusername]/Homestead
cd /mnt/c/Users/[yourusername]/Homestead
bash init.sh

• Typescript

npm install -g typescript

• Append to the Vagrantfile file in the Homestead folder, inside Vagrant.configure

config.vm.provider "virtualbox" do |v|
    v.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
end

• Start the homestead machine

homestead up

• Create the ssh key

ssh-keygen -o

• Install zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

• Add zsh-autosuggestions and ssh-agent plugins to the .zshrc file

plugins=(git ssh-agent zsh-autosuggestions)

• Setup the local folder at the Homestead.yaml file to be /mnt/c/Users/[yourusername]/Documents/code

folders:
    - map: /mnt/c/Users/[yourusername]/Documents/code
      to: /home/vagrant/code

• Start the Homestead VM

homestead up

Warning message suppression

• In order to supress the "Insecure world writable dir /home/[yourusername]/.config/composer/vendor/bin" warning:

sudo chmod 755 ~/.config -R

• In order to supress the "Insecure world writable dir /mnt/c" warning, create the /etc/wsl.conf file:

sudo nano /etc/wsl.conf

[automount]
options="metadata,umask=0033"

Windows Terminal

• Change the 'defaultProfile' settings to the guid of the terminal you want as default
• Set your home directory as the start directory for the WSL terminal

"startingDirectory": "/\\wsl$/\\Ubuntu/\\home/\\[yourusername]"

Visual Studio Code

• Install the Remote - WSL extensioncode