Installing Git on Your Computer

In this workshop, we will be working with a version control software called git.

First, let's make sure you have git installed. You can find general install instructions on Github. The approach depends on your operating system:

• Windows: You can install git via git for Windows.
• Mac: It is very likely git is already on your Mac. You can open a terminal and run git version to make sure. If it's not installed, you can install it using Homebrew by running the command brew install git. You can also install git in a conda environment, if you're using Anaconda. Simply run conda install git.
• Linux: You can use whatever package management system your distribution uses to install git. For Debian/Ubuntu, this is apt. Specifically, run the command sudo apt-get install git-all in a terminal.

Creating a Github Account

Next, you need to make sure you have a Github account. If you have already signed up on Github, go ahead and login right now. If you have not created an account, go to this link and create an account with your email address. Be sure to check your email in order to validate your account. Once you've created an account, sign into Github.

Creating Git Authentication Tools

Github is an online platform to provides a place to store updates to code repositories you might work with. It works tightly with the git software, and provides additional tools to facilitate working with repositories. In order to keep your code safe, Github has some security settings in place that we need to work through before we can use it to its fullest extent.

First, if you haven't already, create an authenticiation token which will be used in order to interact with Github. Go to this link and follow the steps to create the authentication token on Github.

Be sure to save the token in a safe place on your computer. If you lose it, you'll have to create another one.

Another secure approach that is easier to use on a day-to-day basis, but more complicated to install, is to set up SSH keys. See this link for more details.

Cloning this Repository

Now, you can finally clone this repository to your computer (if this terminology doesn't make sense, don't worry - we'll go over it!). Open up a terminal and enter the command:

$ git clone https://github.com/codem0nk3y/pe-training-00-git-basics.git
Username: your_username
Password: your_token

The terminal will ask you for your Github username and authentication token, both of which we obtained in the previous two steps. Enter this information, and then Github will go ahead and place the repository on your computer.

Next Up: Bash

You're all set! We've already used the terminal a little bit in getting set up. The next part of the workshop is learning more details about how to use the terminal with Bash. Go ahead an open up levels/02_bash.md and follow the steps there!