2013-03-02 06:53:27 -05:00
## GitLab: self hosted Git management software
2013-02-27 11:09:48 -05:00
2013-02-27 14:05:57 -05:00
![logo ](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png )
2013-02-27 11:09:48 -05:00
2013-03-02 06:53:27 -05:00
### 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
2013-02-27 14:05:57 -05:00
2013-03-02 06:53:27 -05:00
* powered by Ruby on Rails
* completely free and open source (MIT license)
* used by 10.000 organization to keep their code secure
2013-02-27 14:05:57 -05:00
2013-03-02 06:53:27 -05:00
### Code status
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [![build status ](http://ci.gitlab.org/projects/1/status?ref=master )](http://ci.gitlab.org/projects/1?ref=master) ci.gitlab.org (master branch)
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [![build status ](https://secure.travis-ci.org/gitlabhq/gitlabhq.png )](https://travis-ci.org/gitlabhq/gitlabhq) travis-ci.org (master branch)
2013-02-27 14:05:57 -05:00
2013-02-28 12:30:07 -05:00
* [![Code Climate ](https://codeclimate.com/github/gitlabhq/gitlabhq.png )](https://codeclimate.com/github/gitlabhq/gitlabhq)
2013-03-02 06:53:27 -05:00
2013-02-27 14:05:57 -05:00
* [![Dependency Status ](https://gemnasium.com/gitlabhq/gitlabhq.png )](https://gemnasium.com/gitlabhq/gitlabhq)
2011-11-25 17:30:51 -05:00
2013-03-02 06:53:27 -05:00
### Resources
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* GitLab.org community site: [Homepage ](http://gitlab.org ) [Screenshots ](http://gitlab.org/screenshots/ ) [Blog ](http://blog.gitlab.org/ ) [Demo ](http://demo.gitlabhq.com/users/sign_in )
* GitLab.com: [Homepage ](http://blog.gitlab.com/ ) [Hosted pricing ](http://blog.gitlab.com/pricing/ ) [Services ](http://blog.gitlab.com/services/ ) [Blog ](http://blog.gitlab.com/blog/ )
* GitLab CI: [Readme ](https://github.com/gitlabhq/gitlab-ci/blob/master/README.md ) of the GitLab open-source continuous integration server
2011-11-15 09:41:33 -05:00
2013-02-27 14:05:57 -05:00
### Requirements
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* Ubuntu/Debian*
2012-10-04 06:48:20 -04:00
* ruby 1.9.3+
2012-11-21 05:52:55 -05:00
* MySQL
2011-11-15 09:41:33 -05:00
* git
2013-02-27 11:09:48 -05:00
* gitlab-shell
2012-01-02 15:34:49 -05:00
* redis
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* More details are in the [requirements doc ](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md )
2013-03-02 17:27:52 -05:00
### 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.
2013-03-02 06:53:27 -05:00
* [Installation guide for latest stable release ](https://github.com/gitlabhq/gitlabhq/blob/4-2-stable/doc/install/installation.md )
* [Installation guide for the current master branch ](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md )
* [Vagrant virtual machine ](https://github.com/gitlabhq/gitlab-vagrant-vm )
2013-03-02 17:27:52 -05:00
### Starting
2013-03-02 06:53:27 -05:00
2013-03-03 06:29:57 -05:00
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:
2013-03-02 06:53:27 -05:00
2013-03-03 11:21:36 -05:00
sudo service gitlab start
2013-03-02 06:53:27 -05:00
2013-03-03 11:21:36 -05:00
or
2013-03-02 17:27:52 -05:00
2013-03-03 11:21:36 -05:00
sudo /etc/init.d/gitlab restart
2013-03-02 17:27:52 -05:00
2013-03-03 06:29:57 -05:00
2. Start it with [Foreman ](https://github.com/ddollar/foreman ) in development model
2013-03-02 17:27:52 -05:00
2013-03-03 11:21:36 -05:00
bundle exec foreman start -p 3000
2013-03-02 17:27:52 -05:00
2013-03-03 06:29:57 -05:00
3. Start it manually in development mode
2013-03-02 17:27:52 -05:00
2013-03-03 11:21:36 -05:00
bundle exec rails s
bundle exec rake sidekiq:start
2013-03-02 17:27:52 -05:00
### Running the tests
* Seed the database with
2013-03-03 11:22:56 -05:00
bundle exec rake db:setup RAILS_ENV=test
bundle exec rake db:seed_fu RAILS_ENV=test
2013-03-02 17:27:52 -05:00
* Run all tests
2013-03-02 17:38:48 -05:00
2013-03-03 11:22:56 -05:00
bundle exec rake gitlab:test
2013-03-02 17:27:52 -05:00
* Rspec unit and functional tests
2013-03-02 17:38:48 -05:00
2013-03-03 11:22:56 -05:00
bundle exec rake spec
2013-03-02 17:27:52 -05:00
* Spinach integration tests
2013-03-02 17:38:48 -05:00
2013-03-03 11:22:56 -05:00
bundle exec rake spinach
2013-03-02 06:53:27 -05:00
### Getting help
* [Troubleshooting guide ](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide )
* [Support forum ](https://groups.google.com/forum/#!forum/gitlabhq )
* [Feedback and suggestions forum ](http://gitlab.uservoice.com/forums/176466-general )
* [Paid support ](http://blog.gitlab.com/support/ )
* [Paid services ](http://blog.gitlab.com/services/ )
2013-02-27 16:17:46 -05:00
2013-03-02 17:27:52 -05:00
### New versions and the API
Each month on the 22th a new version is released together with an upgrade guide.
* [Upgrade guides ](https://github.com/gitlabhq/gitlabhq/wiki )
* [Roadmap ](https://github.com/gitlabhq/gitlabhq/blob/master/ROADMAP.md )
2013-03-02 17:38:48 -05:00
### Other documentation
2013-03-02 17:27:52 -05:00
* [GitLab API ](https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md )
2013-03-02 17:38:48 -05:00
* [Rake tasks ](https://github.com/gitlabhq/gitlabhq/tree/master/doc/raketasks )
* [GitLab recipes ](https://github.com/gitlabhq/gitlab-recipes )
2013-03-02 06:53:27 -05:00
### Getting in touch
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [Contributing guide ](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md )
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [Core team ](https://github.com/gitlabhq?tab=members )
2011-12-06 16:11:22 -05:00
2013-03-02 06:53:27 -05:00
* [Contributors ](https://github.com/gitlabhq/gitlabhq/graphs/contributors )
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [Leader ](https://github.com/randx )
2011-11-15 09:41:33 -05:00
2013-03-02 06:53:27 -05:00
* [Contact page ](http://gitlab.org/contact/ )