4.1 KiB
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 Vargrant virtual machine is recommended for development since it makes it much easier to set up all the dependencies for integration testing.
Starting
- The Installation guide contains instructions to download an init script and run that on boot. After configuring the init script you can run
sudo service gitlab start
or
sudo /etc/init.d/gitlab restart
- With foreman
bundle exec foreman start -p 3000
- Start it manually
bundle exec rails s bundle exec rake environment resque:work QUEUE=* VVERBOSE=1
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
New versions and the API
Each month on the 22th a new version is released together with an upgrade guide.