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
• Docker
• VS Code
• PGAdmin
• Optional software

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

Xcode, Homebrew, and Bash

Open your default terminal window and perform the following:

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/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 (M1 Mac Review Required)

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

Node

brew install node

Docker (M1 Mac Review Required)

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 (M1 Mac Review Required)

brew install --cask pgadmin4

Optional Software

MS Cascadia Fonts (optional)

brew tap homebrew/cask-fonts
brew cask install font-cascadia-code
brew cask install font-cascadia-code-pl

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 - M1 Mac Review Required)

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.