gitlabGetting started with gitlab


Remarks

GitLab is a web-based version control software based on git and adds additional features such as branch management bug tracking and continuous integration. It is developed in Ruby.

GitLab Community Edition (CE) is being developed open-source and uses the MIT-License. Since August 2013 GitLab Inc. is providing the enterprise-grade Enterprise Edition (EE) which includes more features than the Community Edition.

GitLab.com is the Software as a Service alternative and runs itself on a Enterprise Edition. It is free of charge and supports private and public repositories.

Versions

VersionRelease Date
8.152016-12-22
8.142016-11-22
8.132016-10-22
8.122016-09-22
8.112016-08-22
8.102016-07-22
8.92016-06-22
8.82016-05-22
8.72016-04-22
8.62016-03-22
8.52016-02-22
8.42016-01-22
8.32015-12-22
8.22015-11-22
8.12015-10-22
8.02015-09-22

Installation or Setup

This is a short summary of the GitLab guide on Install a GitLab CE Omnibus package.

Requirements

In order to install the GitLab Community Edition on your server, you should read the requirements page. To make it brief, the recommended requirements are:

  • OS: Ubuntu, Debian, CentOS, RHEL
  • Ruby version: Ruby (MRI) 2.1.x, currently does not work with versions 2.2 or 2.3.
  • CPU: 2 cores (supports up to 500 users)
  • Memory: 2 GB (supports up to 100 users)
  • Database: PostgreSQL

Installation

The recommended method is to install the Omnibus package, which is fast to install. It contains GitLab and all its dependencies (Ruby, PostgreSQL, Redis, Nginx, Unicorn, etc.). For other methods check out the GitLab's installation options

With Ubuntu 16.04 as the recommended OS, this guide describes the installation steps on Debian based distributions. For CentOS, RHEL, Oracle Linux and Scientific Linux, please refer to the original guides:

Ubuntu, Debian, Raspberrian

Install necessary dependencies. If you use Postfix select 'Internet Site' during setup

sudo apt-get install curl openssh-server ca-certificates postfix apt-transport-https
curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
 

Add the Gitlab package server and install the package

sudo curl -sS https://packages.gitlab.com/install/repositories/gitlab/raspberry-pi2/script.deb.sh | sudo bash
sudo apt-get install gitlab-ce
 

If you do not want to install the repository through a piped script, download the package manually and install it using

dpkg -i gitlab-ce_<version>.deb
 

Now configure and start GitLab

sudo gitlab-ctl reconfigure
 

Finally browse to the hostname and login. At first you will be redirected to provide a password for the initial administrator account. After that you're able to login in. The default administrator account username is root.