GitLab: self hosted Git management software

GitLab allows you to

• keep your code secure on your own server
• manage repositories, users and access permissions
• communicate through issues, line-comments and wiki pages
• perform code review with merge requests

GitLab is

• powered by Ruby on Rails
• completely free and open source (MIT license)
• used by 10.000 organizations to keep their code secure

Code status

• ci.gitlab.org (master branch)

• travis-ci.org (master branch)

• 

• 

• 

Resources

• GitLab.org community site: Homepage Screenshots Blog Demo

• GitLab.com commercial services: Homepage GitLab Cloud Subscription Consultancy Blog

• GitLab CI: Readme of the GitLab open-source continuous integration server

Requirements

• Ubuntu/Debian**
• ruby 1.9.3
• MySQL
• git
• gitlab-shell
• redis

** More details are in the requirements doc

Installation

For production

Follow the installation guide for production server.

• Installation guide for latest stable release (5.0) - Recommended

• Installation guide for the current master branch (5.1)

For development

If you want to contribute, please first read our Contributing Guidelines and then we suggest you to use the Vagrant virtual machine project to get an environment working sandboxed and with all dependencies.

• Vagrant virtual machine

Unsupported installation methods

• GitLab recipes for setup on different platforms

• Unofficial installation guides

Starting

1. The Installation guide contains instructions to download an init script and run that on boot. With the init script you can also start GitLab

    sudo service gitlab start
   

or

    sudo /etc/init.d/gitlab restart

2. Start it with Foreman in development mode

    bundle exec foreman start -p 3000
   

or start it manually

    bundle exec rails s
    bundle exec rake sidekiq:start

Running the tests

• Seed the database

    bundle exec rake db:setup RAILS_ENV=test
    bundle exec rake db:seed_fu RAILS_ENV=test
  

• Run all tests

    bundle exec rake gitlab:test
  

• Rspec unit and functional tests

    bundle exec rake spec
  

• Spinach integration tests

    bundle exec rake spinach
  

Getting help

• Troubleshooting guide

• Support forum

• Feedback and suggestions forum

• Support subscription

• Consultancy

New versions and upgrading

Each month on the 22th a new version is released together with an upgrade guide.

• Upgrade guides

• Changelog

• Roadmap

GitLab interfaces

• GitLab API

• Rake tasks

• Directory structure

• Databases

Getting in touch

• Contributing guide

• Core team

• Contributors

• Leader

• Contact page