optionalg / gitlabhq

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 though issues, line-comments and wiki's
• perform code reviews with merge requests

GitLab is

• powered by Ruby on Rails
• completely free and open source (MIT license)
• used by 10.000 organization 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: Homepage Hosted pricing Services 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

You can either follow the "ordinary" Installation guide to install it on a machine or use the Vagrant virtual machine. The Installation guide is recommended to set up a production server. The Vagrant virtual machine is recommended for development since it makes it much easier to set up all the dependencies for integration testing.

• Installation guide for latest stable release (4.2)

• Installation guide for the current master branch (5.0)

• Vagrant virtual machine

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 with:

    sudo service gitlab start
   

or

    sudo /etc/init.d/gitlab restart

2. Start it with Foreman in development model

    bundle exec foreman start -p 3000
   

3. Start it manually in development mode

    bundle exec rails s
    bundle exec rake sidekiq:start
   

Running the tests

• Seed the database with

    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

• Paid support

• Paid services

New versions and the API

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

• Upgrade guides

• Roadmap

Other documentation

• GitLab API

• Rake tasks

• GitLab recipes

Getting in touch

• Contributing guide

• Core team

• Contributors

• Leader

• Contact page