GitLab Documentation
Select Version to Install
Make sure you view this installation guide from the branch (version) of GitLab you would like to install. In most cases this should be the highest numbered stable branch (example shown below).
capture
capture
If this is unclear check the GitLab Blog for installation guide links by version.
Important notes
This guide is long because it covers many cases and includes all commands you need, this is one of the few installation scripts that actually works out of the box.
This installation guide was created for and tested on Debian/Ubuntu operating systems. Please read doc/install/requirements.html for hardware and operating system requirements. If you want to install on RHEL/CentOS we recommend using the Omnibus packages.
This is the official installation guide to set up a production server. To set up a development installation or for many other installation options please see the installation section of the readme.
The following steps have been known to work. Please use caution when you deviate from this guide. Make sure you don't violate any assumptions GitLab makes about its environment. For example many people run into permission problems because they changed the location of directories or run services as the wrong user.
If you find a bug/error in this guide please submit a merge request following the contributing guide.
Overview
The GitLab installation consists of setting up the following components:
Packages / Dependencies
Ruby
System Users
GitLab shell
Database
GitLab
Nginx
1. Packages / Dependencies
sudo is not installed on Debian by default. Make sure your system is up-to-date and install it.
# run as root!
apt-get update -y
apt-get upgrade -y
apt-get install sudo -y
Note: During this installation some files will need to be edited manually. If you are familiar with vim set it as default editor with the commands below. If you are not familiar with vim please skip this and keep using the default editor.
# Install vim and set as default editor
sudo apt-get install -y vim
sudo update-alternatives --set editor /usr/bin/vim.basic
Install the required packages (needed to compile Ruby and native extensions to Ruby gems):
sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server redis-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate
Make sure you have the right version of Git installed
# Install Git
sudo apt-get install -y git-core
# Make sure Git is version 1.7.10 or higher, for example 1.7.12 or 1.8.4
git --version
Is the system packaged Git too old? Remove it and compile from source.
# Remove packaged Git
