README.md

   1 # Welcome to GitLab [![build status](https://secure.travis-ci.org/gitlabhq/gitlabhq.png)](https://secure.travis-ci.org/gitlabhq/gitlabhq)
   2
   3 GitLab is a free Project/Repository management application
   4
   5
   6 <img src="http://gitlabhq.com/front.png" width="900" height="471">
   7
   8
   9 ## Application details
  10
  11 rails 3.1
  12 works only with gitolite
  13 sqlite as default a database
  14
  15 ## Requirements
  16
  17 * ruby 1.9.2
  18 * sqlite
  19 * git
  20 * gitolite
  21 * ubuntu/debian
  22 * pygments lib - `sudo easy_install pygments`
  23
  24 ## Install Project
  25
  26 ```bash
  27 git clone git://github.com/gitlabhq/gitlabhq.git
  28
  29 cd gitlabhq/
  30
  31 # install this library first
  32 sudo pip install pygments
  33 sudo apt-get install python-dev
  34
  35 # give your user access to remove git repo
  36 # Ex.
  37 #   If you are going to use user 'gitlabhq' for rails server
  38 #   gitlabhq ALL = (git) NOPASSWD: /bin/rm" | sudo tee -a /etc/sudoers
  39 #
  40 echo "USERNAME ALL = (git) NOPASSWD: /bin/rm" | sudo tee -a /etc/sudoers
  41
  42 sudo gem install bundler
  43
  44 bundle install --without development test
  45
  46 bundle exec rake db:setup RAILS_ENV=production
  47
  48 # create admin user
  49 # login....admin@local.host
  50 # pass.....5iveL!fe
  51 bundle exec rake db:seed_fu RAILS_ENV=production
  52 ```
  53
  54 Install gitolite (with repo umask 0007), edit `config/gitlab.yml` and start server
  55
  56 ```bash
  57 bundle exec rails s -e production
  58 ```
  59
  60
  61 ## Install Gitolite
  62
  63
  64 ```bash
  65
  66
  67 # create git user
  68 sudo adduser \
  69   --system \
  70   --shell /bin/sh \
  71   --gecos 'git version control' \
  72   --group \
  73   --disabled-password \
  74   --home /home/git \
  75   git
  76
  77
  78 # Add your user to git group
  79 usermod -a -G git gitlabhq_user_name
  80
  81 ```
  82
  83 ### !!! IMPORTANT !!! Gitolite should have repository umask 0007 so users from git group has read/write access to repo
  84
  85 ```bash
  86
  87 # copy your pub key to git home
  88 cp ~/.ssh/id_rsa.pub /home/git/rails.pub
  89
  90 # enter user git
  91 sudo -i -u git
  92
  93 # clone gitolite
  94 git clone git://github.com/gitlabhq/gitolite
  95
  96 # install gitolite
  97 gitolite/src/gl-system-install
  98
  99
 100 # Setup (Dont forget to set umask as 0007!!)
 101 gl-setup ~/rails.pub
 102
 103
 104 ```
 105
 106
 107 ## Install ruby 1.9.2
 108
 109 ```bash
 110 sudo aptitude install git-core curl gcc checkinstall libxml2-dev libxslt-dev sqlite3 libsqlite3-dev libcurl4-openssl-dev libreadline5-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev
 111
 112 wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.2-p290.tar.gz
 113
 114 tar xfvz ruby-1.9.2-p290.tar.gz
 115
 116 cd ruby-1.9.2-p290
 117 ./configure
 118 make
 119 sudo checkinstall -D
 120
 121 sudo gem update --system
 122
 123 echo "gem: --no-rdoc --no-ri" > ~/.gemrc
 124 ```
 125
 126 ## Community
 127
 128 [Google Group](https://groups.google.com/group/gitlabhq)
 129
 130 ## Contribute
 131
 132 We develop project on our private server.
 133 Want to help? Contact us on twitter or email to become a team member.