Mac OSX

SEI Install Fest

PART 1

For the first portion of the class, we'll be working exclusively inside of the browser and Node. We'll be installing the following tools.

  • Slack

  • Homebrew

  • iTerm

  • Oh my ZSH

  • VS Code

  • Git

Slack

We will be using slack to communicate throughout the course. You should've received an invite to our channels via e-mail. You can login via the web browser, but downloading / installing the app is highly recommended.

Download Slack

iTerm

iTerm is a tricked out version of the Terminal app that is the default command line interface for Mac. It will help with the visuals of the command line navigation, especially with ohmyZSH.

Download here

Install Oh My ZSH

Oh my ZSH?!!! We will be tricking out commandline with another shell. A shell is an interface into our computer, and we will be using a lot to run commands.

We'll be using a shell and configuration package called Oh-My-Zsh

Visit the [iTerm website] for install instructions. Open iTerm and run the command listed on the site.

If it prompts you to change your default shell to zsh, select yes! When it asks you for your password, enter your computer user password (it wont show up, but iTerm is keeping track of your keystrokes).

Restart Terminal, and you should see a brand new and colorful command prompt.

Homebrew

Homebrew is a package manager that we will use to install various command line tools in our class.

Visit the homebrew website for install instructions.

You may be prompted to installed XCode command line tools. When prompted, click and install through that, and you're homebrew installation will continue.

After the installation process, run the command brew doctor. If any warnings or errors are displayed, we will need to resolve them before proceeding with the rest of the install fest.

Xcode

We do not use Xcode in class but some other applications that we do use require some Xcode libraries. Normally, all you need is the Xcode CLI which should have already been installed when you installed Homebrew. If it didn't get installed, you can use this command:

xcode-select --install

If you need to, you can install Xcode through the App Store. Link here

GIT

Before we do this process, please make sure you have signed up for an account on Github. We will be installing a version of GIT from home brew and also configuring it.

To install GIT

brew install git

Configuring GIT

Using your email credentials for GIT, run these commands with your user and email configured.

git config --global user.name "YOUR-USERNAME"
git config --global user.email "YOUR-EMAIL-ADDRESS"
git config --global push.default simple
git config --global credential.helper cache

Connecting to Github with SSH

You might find your self having to re-authenticate GIT every time you work on your command line. Setup SSH Keys to let Github remember your machine in the future. We have two ways:

OR

Install VS Code

Currently the most popular editor according to developer polls. This is Microsoft's free version of Visual Studio.

Download and install VS Code from here

To be able to open VS Code from any directory, add it to your path inside your ~/.zshrc file:

export PATH=$PATH:"/Applications/Visual Studio Code.app/Contents/Resources/app/bin"

# setting code on path
export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
alias code="/Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code"

Save this file and then fully restart your terminal window (quit and restart.)

Part 2

Node

To install Node

brew install node

Verify the installation afterwards by running

node -v
npm -v

The above should display without any errors.

To finish up your installation, run this command to allow for global installations of npm tools.

sudo chown -R $USER /usr/local/lib

Postgres

Postgres.app

We will be using a relational database called Postgres during our class.

Download and install from http://postgresapp.com/

If you have successfully configured zsh and vs code, the following command should work.

code ~/.zshrc
# PostgreSQL psql
# open your ~/.zshrc file, copy & paste this command below
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/latest/bin

Your sublime (or Atom) editor will popup with configuration settings, at the bottom of the file append

export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/9.6/bin

Type which psql at which point should display

/Applications/Postgres.app/Contents/Versions/9.5/bin/psql

Install Postgres GUI

We'll be using Postico. Install here:

https://eggerapps.at/postico/

Part 3 OSX installfest

Installing MongoDB (Updated 2/2021)

Notes: The name of the free version of MongoDB has changed to mongodb-community as of November 2019. Also, the Catalina version of MacOS (version 10.15) disallows folders being created at the root of the file system so you must create your MongoDB data folder inside your home folder

# Download the official Homebrew formula for MongoDB and the Database Tools
brew tap mongodb/brew

#Install MongoDB
brew install mongodb-community@4.4

There are two ways to start your server: 1. As a macOS service 2. Manually as a background process

As a Service

# Start
brew services start mongodb-community@4.4

# Stop
brew services stop mongodb-community@4.4

As a Background Process

# For Mac running Intel processors
mongod --config /usr/local/etc/mongod.conf --fork

# For Apple M1 processors
mongod --config /opt/homebrew/etc/mongod.conf --fork
or 
1. Go to your developer account
2. Search for Command Line Tools for Xcode 13.2 and install the package
3. run brew tap mongodb/brew
4. run brew services start mongodb-community@5.0
5. run mongod --config /opt/homebrew/etc/mongod.conf 
6. then run mongo 

Part 4

Installing Python 3

Brew is also used to install Python 3. (Python 2 is already installed on your Mac.) To install Python 3 without errors, we first need to create a couple directories and change them to be owned by us:

mkdir /usr/local/lib
mkdir /usr/local/Frameworks
whoami

Make a note of the username returned from whoami. Enter that username in place of USERNAME below:

sudo chown -R USERNAME:wheel /usr/local/lib
sudo chown -R USERNAME:wheel /usr/local/Frameworks

If you received no errors from those commands, then use this command to install version 3:

brew install python3

You can test the installation by running python3 --version.

This should also install pip3, a package installer for Python 3. You can verify that it is installed and working by updating it with the following command:

pip3 install --upgrade pip setuptools wheel

This should return some normal messages - no errors. Now that pip3 is working, we can use it to install a useful Python shell:

pip3 install ipython

iPython makes it easy to write python code in your terminal. We may not use it a huge amount but it is handy to have around.

Installing Django

We will also use pip3 to install Django, a robust back-end server for Python. We will be installing the 2.0.x version:

pip3 install Django

Last updated