gitlab-org--gitlab-foss/README.md

## GitLab: self hosted Git management software

![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)

### 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

* [![build status](http://ci.gitlab.org/projects/1/status?ref=master)](http://ci.gitlab.org/projects/1?ref=master) ci.gitlab.org (master branch)

* [![build status](https://secure.travis-ci.org/gitlabhq/gitlabhq.png)](https://travis-ci.org/gitlabhq/gitlabhq) travis-ci.org (master branch)

* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)

* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)

### Resources

* 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

### Requirements

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

* More details are in the [requirements doc](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md)

### Getting started

* [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)

* [Developer guide](https://github.com/gitlabhq/gitlabhq/wiki/Developer-Guide)

* [Upgrade guides](https://github.com/gitlabhq/gitlabhq/wiki)

* [Roadmap](https://github.com/gitlabhq/gitlabhq/blob/master/ROADMAP.md)

* [GitLab API](https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md)

### 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/)

### Getting in touch

* [Contributing guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)

* [Core team](https://github.com/gitlabhq?tab=members)

* [Contributors](https://github.com/gitlabhq/gitlabhq/graphs/contributors)

* [Leader](https://github.com/randx)

* [Contact page](http://gitlab.org/contact/)
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`## GitLab: self hosted Git management software`
Update README 2013-02-27 11:09:48 -05:00
trying new readme 2013-02-27 14:05:57 -05:00			`![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)`
Update README 2013-02-27 11:09:48 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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`
trying new readme 2013-02-27 14:05:57 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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`
trying new readme 2013-02-27 14:05:57 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`### Code status`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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)`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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)`
trying new readme 2013-02-27 14:05:57 -05:00
docs improvement 2013-02-28 12:30:07 -05:00			`* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)`
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00
trying new readme 2013-02-27 14:05:57 -05:00			`* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)`
updated readme 2011-11-25 17:30:51 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`### Resources`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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`
brand new README 2011-11-15 09:41:33 -05:00
trying new readme 2013-02-27 14:05:57 -05:00			`### Requirements`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* Ubuntu/Debian*`
ruby version changed 2012-10-04 06:48:20 -04:00			`* ruby 1.9.3+`
Updated README 2012-11-21 05:52:55 -05:00			`* MySQL`
brand new README 2011-11-15 09:41:33 -05:00			`* git`
Update README 2013-02-27 11:09:48 -05:00			`* gitlab-shell`
updated readme 2012-01-02 15:34:49 -05:00			`* redis`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 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)`

			`### Getting started`

			`* [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)`

			`* [Developer guide](https://github.com/gitlabhq/gitlabhq/wiki/Developer-Guide)`

			`* [Upgrade guides](https://github.com/gitlabhq/gitlabhq/wiki)`

			`* [Roadmap](https://github.com/gitlabhq/gitlabhq/blob/master/ROADMAP.md)`

			`* [GitLab API](https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/README.md)`

			`### 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/)`
Link to new contributing file and the requirements doc. 2013-02-27 16:17:46 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`### Getting in touch`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* [Contributing guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* [Core team](https://github.com/gitlabhq?tab=members)`
fixed readme md 2011-12-06 16:11:22 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* [Contributors](https://github.com/gitlabhq/gitlabhq/graphs/contributors)`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* [Leader](https://github.com/randx)`
brand new README 2011-11-15 09:41:33 -05:00
Cleaned up and enhanced readme. Finishing touches. Make the layout more consistent. 2013-03-02 06:53:27 -05:00			`* [Contact page](http://gitlab.org/contact/)`