91 lines
3.1 KiB
Markdown
91 lines
3.1 KiB
Markdown
---
|
|
author: Sean Packham
|
|
author_gitlab: SeanPackham
|
|
level: beginner
|
|
article_type: user guide
|
|
date: 2017-05-15
|
|
description: 'This article describes how to install Git on macOS, Ubuntu Linux and Windows.'
|
|
type: howto
|
|
last_updated: 2019-05-31
|
|
---
|
|
|
|
# Installing Git
|
|
|
|
To begin contributing to GitLab projects,
|
|
you will need to install the Git client on your computer.
|
|
|
|
This article will show you how to install Git on macOS, Ubuntu Linux and Windows.
|
|
|
|
Information on [installing Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
|
|
is also available at the official Git website.
|
|
|
|
## Install Git on macOS using the Homebrew package manager
|
|
|
|
Although it is easy to use the version of Git shipped with macOS
|
|
or install the latest version of Git on macOS by downloading it from the project website,
|
|
we recommend installing it via Homebrew to get access to
|
|
an extensive selection of dependency managed libraries and applications.
|
|
|
|
If you are sure you don't need access to any additional development libraries
|
|
or don't have approximately 15gb of available disk space for Xcode and Homebrew,
|
|
use one of the aforementioned methods.
|
|
|
|
### Installing Xcode
|
|
|
|
Xcode is needed by Homebrew to build dependencies.
|
|
You can install [XCode](https://developer.apple.com/xcode/)
|
|
through the macOS App Store.
|
|
|
|
### Installing Homebrew
|
|
|
|
Once Xcode is installed browse to the [Homebrew website](https://brew.sh/index.html)
|
|
for the official Homebrew installation instructions.
|
|
|
|
### Installing Git via Homebrew
|
|
|
|
With Homebrew installed you are now ready to install Git.
|
|
Open a Terminal and enter in the following command:
|
|
|
|
```sh
|
|
brew install git
|
|
```
|
|
|
|
Congratulations you should now have Git installed via Homebrew.
|
|
|
|
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
|
|
|
## Install Git on Ubuntu Linux
|
|
|
|
On Ubuntu and other Linux operating systems
|
|
it is recommended to use the built in package manager to install Git.
|
|
|
|
Open a Terminal and enter in the following commands
|
|
to install the latest Git from the official Git maintained package archives:
|
|
|
|
```sh
|
|
sudo apt-add-repository ppa:git-core/ppa
|
|
sudo apt-get update
|
|
sudo apt-get install git
|
|
```
|
|
|
|
Congratulations you should now have Git installed via the Ubuntu package manager.
|
|
|
|
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
|
|
|
## Installing Git on Windows from the Git website
|
|
|
|
Browse to the [Git website](https://git-scm.com/) and download and install Git for Windows.
|
|
|
|
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
|
|
|
<!-- ## Troubleshooting
|
|
|
|
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
|
|
one might have when setting this up, or when something is changed, or on upgrading, it's
|
|
important to describe those, too. Think of things that may go wrong and include them here.
|
|
This is important to minimize requests for support, and to avoid doc comments with
|
|
questions that you know someone might ask.
|
|
|
|
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
|
|
If you have none to add when creating a doc, leave this section in place
|
|
but commented out to help encourage others to add to it in the future. -->
|