Skip to content
This repository

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

README.md

GitLab: self hosted Git management software

logo

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 ci.gitlab.org (master branch)

  • build status travis-ci.org (master branch)

  • Code Climate

  • Dependency Status

  • Coverage Status

Resources

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.

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

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

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.