Skip to content
This repository

Project management and code hosting application. Follow us on twitter @gitlabhq

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

  • build status (master branch)

  • build status (master branch)

  • Code Climate

  • Dependency Status

  • Coverage Status



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

** More details are in the requirements doc


For production

Follow the installation guide for production server.

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.

Unsupported installation methods


  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


      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

New versions and upgrading

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

GitLab interfaces

Getting in touch

Something went wrong with that request. Please try again.