README.md 3.07 KB
Newer Older
1
## GitLab: self hosted Git management software
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
2

Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
3
![logo](https://raw.github.com/gitlabhq/gitlabhq/master/public/gitlab_logo.png)
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
4

5 6 7 8 9 10 11
### 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
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
12

13 14 15
* powered by Ruby on Rails
* completely free and open source (MIT license)
* used by 10.000 organization to keep their code secure
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
16

17
### Code status
Nihad Abbasov's avatar
Nihad Abbasov committed
18

19
* [![build status](http://ci.gitlab.org/projects/1/status?ref=master)](http://ci.gitlab.org/projects/1?ref=master) ci.gitlab.org (master branch)
Nihad Abbasov's avatar
Nihad Abbasov committed
20

21
* [![build status](https://secure.travis-ci.org/gitlabhq/gitlabhq.png)](https://travis-ci.org/gitlabhq/gitlabhq) travis-ci.org (master branch)
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
22

Un1matr1x's avatar
Un1matr1x committed
23
* [![Code Climate](https://codeclimate.com/github/gitlabhq/gitlabhq.png)](https://codeclimate.com/github/gitlabhq/gitlabhq)
24

Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
25
* [![Dependency Status](https://gemnasium.com/gitlabhq/gitlabhq.png)](https://gemnasium.com/gitlabhq/gitlabhq)
Dmitriy Zaporozhets's avatar
Dmitriy Zaporozhets committed
26

27
### Resources
Nihad Abbasov's avatar
Nihad Abbasov committed
28

29 30 31 32 33
* 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
Nihad Abbasov's avatar
Nihad Abbasov committed
34

Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
35
### Requirements
Nihad Abbasov's avatar
Nihad Abbasov committed
36

37
* Ubuntu/Debian*
Valeriy's avatar
Valeriy committed
38
* ruby 1.9.3+
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
39
* MySQL
Nihad Abbasov's avatar
Nihad Abbasov committed
40
* git
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
41
* gitlab-shell
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
42
* redis
Nihad Abbasov's avatar
Nihad Abbasov committed
43

44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
* 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/)
73

74
### Getting in touch
Nihad Abbasov's avatar
Nihad Abbasov committed
75

76
* [Contributing guide](https://github.com/gitlabhq/gitlabhq/blob/master/CONTRIBUTING.md)
Nihad Abbasov's avatar
Nihad Abbasov committed
77

78
* [Core team](https://github.com/gitlabhq?tab=members)
Dmytro Zaporozhets's avatar
Dmytro Zaporozhets committed
79

80
* [Contributors](https://github.com/gitlabhq/gitlabhq/graphs/contributors)
Nihad Abbasov's avatar
Nihad Abbasov committed
81

82
* [Leader](https://github.com/randx)
Nihad Abbasov's avatar
Nihad Abbasov committed
83

84
* [Contact page](http://gitlab.org/contact/)