installation.md

This installation guide was created for Debian/Ubuntu and tested on it.

Please read doc/install/requirements.md for hardware and platform requirements.

Important Note: The following steps have been known to work. If you deviate from this guide, do it with caution and make sure you don't violate any assumptions GitLab makes about its environment. For things like AWS installation scripts, init scripts or config files for alternative web server have a look at the "Advanced Setup Tips" section.

Important Note: If you find a bug/error in this guide please submit an issue or pull request following the contribution guide (see CONTRIBUTING.md).

---

Overview

The GitLab installation consists of setting up the following components:

1. Packages / Dependencies
2. Ruby
3. System Users
4. Gitolite
5. Database
6. GitLab
7. Nginx

1. Packages / Dependencies

sudo is not installed on Debian by default. If you don't have it you'll need to install it first.

# run as root
apt-get update && apt-get upgrade && apt-get install sudo

Make sure your system is up-to-date:

sudo apt-get update
sudo apt-get upgrade

Note: Vim is an editor that is used here whenever there are files that need to be edited by hand. But, you can use any editor you like instead.

# Install vim
sudo apt-get install -y vim

Install the required packages:

sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl git-core openssh-server redis-server postfix checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev

Make sure you have the right version of Python installed.

# Install Python
sudo apt-get install python

# Make sure that Python is 2.5+ (3.x is not supported at the moment)
python --version

# If it's Python 3 you might need to install Python 2 separately
sudo apt-get install python2.7

# Make sure you can access Python via python2
python2 --version

# If you get a "command not found" error create a link to the python binary
sudo ln -s /usr/bin/python /usr/bin/python2

2. Ruby