summaryrefslogtreecommitdiff
path: root/doc/gitlab-basics/start-using-git.md
diff options
context:
space:
mode:
authorkaren Carias <karen@gitlab.com>2015-06-30 08:57:17 -0700
committerkaren Carias <karen@gitlab.com>2015-06-30 08:57:17 -0700
commit1c9cca5e06a5242fca7ca0717f7392e7b0964871 (patch)
treed41d7eb5bb5ec12ebbed0c73baf12dfff02601be /doc/gitlab-basics/start-using-git.md
parent437ecdf2b01de1983fc5262f064323de706027c9 (diff)
downloadgitlab-ce-1c9cca5e06a5242fca7ca0717f7392e7b0964871.tar.gz
renamed files with hyphen
Diffstat (limited to 'doc/gitlab-basics/start-using-git.md')
-rw-r--r--doc/gitlab-basics/start-using-git.md67
1 files changed, 67 insertions, 0 deletions
diff --git a/doc/gitlab-basics/start-using-git.md b/doc/gitlab-basics/start-using-git.md
new file mode 100644
index 00000000000..99103469ccc
--- /dev/null
+++ b/doc/gitlab-basics/start-using-git.md
@@ -0,0 +1,67 @@
+# Start using Git on the commandline
+
+If you want to start using a Git and GitLab, make sure that you have created an account on [gitlab.com](https://about.gitlab.com/)
+
+## Open a shell
+
+* Depending on your operating system, find the shell of your preference. Here are some suggestions
+
+- [Terminal](http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line) on Mac OSX
+
+- [GitBash](https://msysgit.github.io) on Windows
+
+- [Linux Terminal](http://www.howtogeek.com/140679/beginner-geek-how-to-start-using-the-linux-terminal/) on Linux
+
+## Check if Git has already been installed
+
+* Git is usually preinstalled on Mac and Linux
+
+* Type the following command and then press enter
+
+```
+git --version
+```
+
+* You should receive a message that will tell you which Git version you have in your computer. If you don’t receive a "Git version" message, it means that you need to [download Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+
+* If Git doesn't automatically download, there's an option on the website to [download manually](https://git-scm.com/downloads). Then follow the steps on the installation window
+
+* After you finished installing, open a new shell and type "git --version" again to verify that it was correctly installed
+
+## Add your Git username and set your email
+
+* It is important because every Git commit that you create will use this information
+
+* On your shell, type the following command to add your username
+
+```
+git config --global user.name ADD YOUR USERNAME
+```
+
+* Then verify that you have the correct username
+
+```
+git config --global user.name
+```
+
+* To set your email address, type the following command
+
+```
+git config --global user.email ADD YOUR EMAIL
+```
+
+* To verify that you entered your email correctly, type
+
+```
+git config --global user.email
+```
+
+* You'll need to do this only once because you are using the "--global" option. It tells Git to always use this information for anything you do on that system. If you want to override this with a different username or email address for specific projects, you can run the command without the "--global" option when you’re in that project
+
+## Check your information
+
+* To view the information that you entered, type
+
+```
+git config --global --list
+```