Mac

Mac Workstation Setup

Requirements

• MacOS Catalina
• i7 or higher processor and 16GB of RAM.

Software Install

• Xcode
• Homebrew and Bash
• Chrome
• .Net Core 5.0 and EF tooling
• Node
• Node-Sass
• Docker
• VS Code
• PGAdmin
• Optional software

During the installation process you will be asked for your password multiple times.

Xcode

Download and install from Apple Store. Open Xcode after installation, accept licensing agreement and proceed with any additional updates that may be required. Note: this installation may take awhile.

Homebrew and Bash

Open your default terminal window and perform the following:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

You will have to accept the install of XCode to continue - this will take sometime to complete.

Once complete, execute the following commands in the same terminal window:

brew install bash
echo '/usr/local/bin/bash' | sudo tee -a /etc/shells;
chsh -s /usr/local/bin/bash

Chrome

brew cask install google-chrome

.Net Core

brew cask install dotnet-sdk
dotnet tool install --global dotnet-ef

Node

brew install node

Node-Sass

brew install node-sass

Docker

brew cask install docker

Start Docker from the launchpad which should immediately prompt you with

• Docker Desktop needs privileged access

Click ok and enter your password and then click "Install Helper" to complete the installation.

A docker tutorial "Get Started With Docker" will open automatically and you can skip or or not.

VS Code

brew install --cask visual-studio-code

PGAdmin

brew install --cask pgadmin4

Optional Software

MS Cascadia Fonts (optional)

curl  -LOJ  https://github.com/microsoft/cascadia-code/releases/download/v2007.01/CascadiaCode-2007.01.zip
sudo unzip -j -d /Library/Fonts CascadiaCode-2007.01.zip ttf/\*
rm CascadiaCode-2007.01.zip

Configure VS Code to use the Cascadia Code font and ligatures by

• Launching code
• Going to: Code/Preferences/Settings
• Clicking on: Text Editor/Font
• Edit Font Family and Prepend: 'Cascadia Code' to the existing list of fonts
• Enable Ligatures by editing settings.json and setting "editor.fontLagatures": true

You should have a settings.json similar to

{
    "editor.fontFamily": "'Cascadia Code', Menlo, Monaco, 'Courier New', monospace",
    "editor.fontLigatures": true
}

Save your settings.json file.

iTerm2

brew install --cask iterm2

Configure iTerm to use Cascadia Code font and ligatures by

• Launching iTerm
• Going to Profiles/Open Profiles...
• Click Edit Profiles
• Select Default (left pane)
• Select Text Tab (right pane)
• Change the font to Cascadia Code PL
• Check Use Ligatures
• Close settings and restart iTerm

Visual Studio (optional)

brew cask install visual-studio

Perform the following to configure Visual Studio to use the correct NodeJS:

• From a bash shell execute

which nvm

• Copy the path that was reported from above and launch Visual Studio
• Select menu Visual Studio/Preferences...
• Select External Tools
• Click Add

Go and Powerline Go (optional)

brew install go
go install github.com/justjanne/powerline-go@latest

Add the following to your .bash_profile

GOPATH=$HOME/go
function _update_ps1() {
    PS1="$($GOPATH/bin/powerline-go -error $?)"
}
if [ "$TERM" != "linux" ] && [ -f "$GOPATH/bin/powerline-go" ]; then
    PROMPT_COMMAND="_update_ps1; $PROMPT_COMMAND"
fi

Close your iTerm window and restart.

Ensure that you run the application in Chrome as Safari had a known authentication error.

Please proceed to the General Setup section to complete your Health Gateway development environment.