gitlabhq/README.md

85 lines
3.1 KiB
Markdown
Raw Normal View History

## GitLab: self hosted Git management software
2013-02-27 17:09:48 +01:00
2013-02-27 20:05:57 +01:00
![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)
2013-02-27 17:09:48 +01: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 20:05:57 +01: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 20:05:57 +01:00
### Code status
2011-11-15 15:41:33 +01: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 15:41:33 +01: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 20:05:57 +01:00
2013-02-28 18:30:07 +01:00
* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)
2013-02-27 20:05:57 +01:00
* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)
2011-11-25 23:30:51 +01:00
### Resources
2011-11-15 15:41:33 +01: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 15:41:33 +01:00
2013-02-27 20:05:57 +01:00
### Requirements
2011-11-15 15:41:33 +01:00
* Ubuntu/Debian*
2012-10-04 12:48:20 +02:00
* ruby 1.9.3+
2012-11-21 11:52:55 +01:00
* MySQL
2011-11-15 15:41:33 +01:00
* git
2013-02-27 17:09:48 +01:00
* gitlab-shell
2012-01-02 21:34:49 +01:00
* redis
2011-11-15 15:41:33 +01: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/)
### Getting in touch
2011-11-15 15:41:33 +01:00
* [Contributing guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)
2011-11-15 15:41:33 +01:00
* [Core team](https://github.com/gitlabhq?tab=members)
2011-12-06 22:11:22 +01:00
* [Contributors](https://github.com/gitlabhq/gitlabhq/graphs/contributors)
2011-11-15 15:41:33 +01:00
* [Leader](https://github.com/randx)
2011-11-15 15:41:33 +01:00
* [Contact page](http://gitlab.org/contact/)