> For the complete documentation index, see [llms.txt](https://ga0-2.gitbook.io/seifxr10anz-content/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ga0-2.gitbook.io/seifxr10anz-content/week-1/day-1-intros-installs-and-command-line/installation-macos.md).

# Installation (MacOS)

##

## MacOS Installation Instructions

#### [Google Chrome](https://www.google.com/intl/en_au/chrome/)

#### [Visual Studio Code](https://code.visualstudio.com/Download)

#### Terminal Emulator

MacOS's default Terminal.app is good enough but if you want something better, install [iTerm2](https://iterm2.com/).

#### `homebrew` Package Manager

If at any point you get any errors, just ask for help.

1. In your terminal run:

   ```
   xcode-select --install
   ```
2. In your browser, go to [brew.sh](https://brew.sh/)
3. Copy the installation command
4. Open iTerm or Terminal.app
5. Paste the command you copied and press `Enter`
6. Read and follow the prompts
7. When the installation finishes without any errors, if it shows you something similar to this:

![](https://i.imgur.com/BJxaI8j.png)

then run the commands it asks you to one at a time. Restart (**Don't just close the window, QUIT AND RELAUNCH**) your terminal then try running:

```
brew --version
```

If the output doesn't say `"command not found"` then you're good to go. Try running these commands:

```
brew install cowsay
cowsay hello $(whoami)
```

#### ZSH

1. Install the latest version of the Z shell:

   ```
   brew install zsh
   ```
2. Use zsh as your default shell:

   ```
   sudo sh -c "echo $(which zsh) >> /etc/shells"
   chsh -s $(which zsh)
   ```

Restart your terminal.

1. Install [oh-my-zsh](https://ohmyz.sh/):

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

#### `git` and `tree`

Install the `git` and `tree` packages.

```
brew install git tree
```

#### VSCode `code` shortcut

1. In your terminal, run:

   ```
   which code
   ```

   if it shows you a path to the `code` program, you're good to go otherwise proceed to step 2.
2. Launch Visual Studio Code.

* Press `⌘ (Command) + Shift + p`.
* In the input box type `install code` and press Enter.
* Try step 1 again.