2012-12-05 18:31:08 +00:00
|
|
|
This installation guide was created for Debian/Ubuntu and tested on it.
|
|
|
|
|
|
|
|
Please read doc/install/requirements.md for hardware andplatform requirements.
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-03-13 18:19:03 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
**Important Note**
|
|
|
|
The following steps have been known to work.
|
|
|
|
If you deviate from this guide, do it with caution and make sure you don't
|
|
|
|
violate any assumptions GitLab makes about its environment.
|
|
|
|
If you find a bug/error in this guide please an issue or pull request following
|
|
|
|
the contribution guide (see CONTRIBUTING.md).
|
2012-10-10 14:17:23 +00:00
|
|
|
|
2012-10-25 08:13:11 +00:00
|
|
|
- - -
|
2012-03-13 18:19:03 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Overview
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
The GitLab installation consists of setting up th following components:
|
2012-03-28 07:07:24 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
1. Packages / Dependencies
|
2012-10-24 17:59:48 +00:00
|
|
|
2. Ruby
|
2012-12-05 19:34:11 +00:00
|
|
|
3. System Users
|
2012-10-24 17:59:48 +00:00
|
|
|
4. Gitolite
|
2012-12-05 19:34:11 +00:00
|
|
|
5. Database
|
|
|
|
6. GitLab
|
|
|
|
7. Nginx
|
2012-03-12 12:47:57 +00:00
|
|
|
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# 1. Packages / Dependencies
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-09-04 09:26:25 +00:00
|
|
|
*Keep in mind that `sudo` is not installed on Debian by default. You should install it as root:*
|
|
|
|
|
|
|
|
apt-get update && apt-get upgrade && apt-get install sudo
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Make sure your system is up-to-date:
|
2012-03-12 12:47:57 +00:00
|
|
|
|
|
|
|
sudo apt-get update
|
|
|
|
sudo apt-get upgrade
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Install the required packages:
|
2012-10-10 12:45:19 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo apt-get install -y wget curl build-essential checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libreadline6-dev libc6-dev libssl-dev zlib1g-dev libicu-dev redis-server openssh-server git-core python2.7 libyaml-dev postfix
|
2012-10-10 12:45:19 +00:00
|
|
|
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# 2. Ruby
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p327.tar.gz
|
|
|
|
tar xfvz ruby-1.9.3-p327.tar.gz
|
|
|
|
cd ruby-1.9.3-p327
|
2012-03-12 12:47:57 +00:00
|
|
|
./configure
|
|
|
|
make
|
|
|
|
sudo make install
|
|
|
|
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# 3. System Users
|
|
|
|
|
|
|
|
Create a user for Git and Gitolite:
|
2012-08-26 14:18:13 +00:00
|
|
|
|
2012-03-12 12:47:57 +00:00
|
|
|
sudo adduser \
|
|
|
|
--system \
|
|
|
|
--shell /bin/sh \
|
2012-12-05 19:34:11 +00:00
|
|
|
--gecos 'Git Version Control' \
|
2012-03-12 12:47:57 +00:00
|
|
|
--group \
|
|
|
|
--disabled-password \
|
|
|
|
--home /home/git \
|
|
|
|
git
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Create a user for GitLab:
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo adduser --disabled-login --gecos 'GitLab' gitlab
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Add it to the git group
|
|
|
|
sudo addmod -a -G git gitlab
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Generate the SSH key
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u gitlab -H ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-10-24 17:59:48 +00:00
|
|
|
|
|
|
|
# 4. Gitolite
|
|
|
|
|
2012-09-04 09:26:25 +00:00
|
|
|
Clone GitLab's fork of the Gitolite source code:
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u git -H git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Setup Gitolite with GitLab as its admin:
|
|
|
|
|
|
|
|
**Important Note**
|
|
|
|
GitLab assumes *full and unshared* control over this Gitolite installation.
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Add Gitolite scripts to $PATH
|
2012-08-28 23:03:04 +00:00
|
|
|
cd /home/git
|
|
|
|
sudo -u git -H mkdir bin
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u git -H sh -c 'echo -e "PATH=\$PATH:/home/git/bin\nexport PATH" >> /home/git/.profile'
|
|
|
|
sudo -u git -H sh -c 'gitolite/install -ln /home/git/bin'
|
2012-08-28 23:03:04 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Copy the gitlab user's (public) SSH key ...
|
2012-03-12 12:47:57 +00:00
|
|
|
sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub
|
2012-07-05 22:25:53 +00:00
|
|
|
sudo chmod 0444 /home/git/gitlab.pub
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# ... and use it as the Gitolite admin key for setup
|
2012-08-28 23:03:04 +00:00
|
|
|
sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gitolite setup -pk /home/git/gitlab.pub"
|
2012-08-26 14:18:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Fix the directory permissions for the repository:
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Make sure the repositories dir is owned by git and it stays that way
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo chmod -R ug+rwXs /home/git/repositories/
|
2012-03-12 12:47:57 +00:00
|
|
|
sudo chown -R git:git /home/git/repositories/
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Test if everything works so far
|
|
|
|
|
|
|
|
# Clone the admin repo so SSH adds localhost to known_hosts ...
|
|
|
|
# ... and to be sure your users have access to Gitolite
|
2012-08-26 14:18:13 +00:00
|
|
|
sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# If it succeeded without errors you can remove the cloned repo
|
2012-08-26 14:18:13 +00:00
|
|
|
sudo rm -rf /tmp/gitolite-admin
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
**Impornant Note**
|
|
|
|
If you can't clone the `gitolite-admin` repository: **DO NOT PROCEED WITH INSTALLATION**
|
2012-09-04 09:26:25 +00:00
|
|
|
Check the [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide)
|
2012-12-05 19:34:11 +00:00
|
|
|
and make sure you have followed all of the above steps carefully.
|
2012-03-12 12:47:57 +00:00
|
|
|
|
|
|
|
|
2012-12-05 16:53:24 +00:00
|
|
|
# 5. Database
|
2012-10-24 17:42:55 +00:00
|
|
|
|
2012-12-05 16:53:24 +00:00
|
|
|
See doc/install/databases.md
|
2012-10-24 17:42:55 +00:00
|
|
|
|
|
|
|
|
2012-10-24 17:59:48 +00:00
|
|
|
# 6. GitLab
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
We'll install GitLab into the gitlab user's home directory
|
2012-03-12 12:47:57 +00:00
|
|
|
cd /home/gitlab
|
2012-09-16 10:39:49 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Clone the Source
|
2012-10-24 17:59:48 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Clone the latest stable release
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u gitlab -H git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab
|
2012-09-16 10:39:49 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
**Note***
|
|
|
|
You can change `stable` to `master` if you want the *bleeding edge* version, but
|
|
|
|
do so with caution!
|
2012-09-16 10:39:49 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Configure it
|
2012-10-24 17:59:48 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
cd /home/gitlab/gitlab
|
2012-08-26 14:18:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Copy the example GitLab config
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u gitlab -H cp config/gitlab.yml.example config/gitlab.yml
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Copy the example Unicorn config
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u gitlab -H cp config/unicorn.rb.example config/unicorn.rb
|
2012-10-09 23:41:33 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Make sure to edit both files to match your setup.
|
|
|
|
|
|
|
|
## Install Gems
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-10-24 17:59:48 +00:00
|
|
|
cd /home/gitlab/gitlab
|
2012-10-10 12:45:19 +00:00
|
|
|
|
2012-11-09 13:24:28 +00:00
|
|
|
sudo gem install charlock_holmes --version '0.6.9'
|
2012-10-24 17:59:48 +00:00
|
|
|
sudo gem install bundler
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo -u gitlab -H bundle install --deployment --without development test
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Configure Git
|
2012-11-07 23:47:11 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
GitLab needs to be able to commit and push changes to Gitolite. In order to do
|
|
|
|
that Git requires a username and email. (Please use the `email.from` address
|
|
|
|
for the email)
|
2012-11-07 23:47:11 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo -u gitlab -H git config --global user.name "GitLab"
|
2012-11-07 23:47:11 +00:00
|
|
|
sudo -u gitlab -H git config --global user.email "gitlab@localhost"
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Setup GitLab hooks
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo cp ./lib/hooks/post-receive /home/git/.gitolite/hooks/common/post-receive
|
|
|
|
sudo chown git:git /home/git/.gitolite/hooks/common/post-receive
|
2012-08-26 14:18:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Initialise Database and Activate Advanced Features
|
2012-10-24 17:50:34 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
sudo -u gitlab -H bundle exec rake gitlab:app:setup RAILS_ENV=production
|
2012-09-02 16:31:16 +00:00
|
|
|
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Check Application Status
|
2012-09-04 09:26:25 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Just to check we didn't miss anything.
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 17:21:28 +00:00
|
|
|
sudo -u gitlab -H bundle exec rake gitlab:app:status RAILS_ENV=production
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
```
|
|
|
|
# OUTPUT EXAMPLE
|
|
|
|
Starting diagnostic
|
|
|
|
config/database.yml............exists
|
|
|
|
config/gitlab.yml............exists
|
|
|
|
/home/git/repositories/............exists
|
|
|
|
/home/git/repositories/ is writable?............YES
|
|
|
|
remote: Counting objects: 603, done.
|
|
|
|
remote: Compressing objects: 100% (466/466), done.
|
|
|
|
remote: Total 603 (delta 174), reused 0 (delta 0)
|
|
|
|
Receiving objects: 100% (603/603), 53.29 KiB, done.
|
|
|
|
Resolving deltas: 100% (174/174), done.
|
|
|
|
Can clone gitolite-admin?............YES
|
|
|
|
UMASK for .gitolite.rc is 0007? ............YES
|
|
|
|
/home/git/share/gitolite/hooks/common/post-receive exists? ............YES
|
|
|
|
```
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
If you are all green - congratulations! You run a GitLab now.
|
|
|
|
But there are still a few steps to go.
|
2012-03-12 12:47:57 +00:00
|
|
|
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Install Init Script
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Download the init script (will be /etc/init.d/gitlab):
|
2012-09-19 01:53:27 +00:00
|
|
|
|
2012-10-24 17:50:34 +00:00
|
|
|
sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/init.d/gitlab -P /etc/init.d/
|
|
|
|
sudo chmod +x /etc/init.d/gitlab
|
2012-09-19 01:53:27 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Make GitLab start on boot:
|
2012-09-19 01:53:27 +00:00
|
|
|
|
2012-10-24 17:50:34 +00:00
|
|
|
sudo update-rc.d gitlab defaults 21
|
2012-03-13 18:19:03 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
|
|
|
|
Start your GitLab instance:
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-10-24 17:50:34 +00:00
|
|
|
sudo service gitlab start
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-10-24 17:50:34 +00:00
|
|
|
# 7. Nginx
|
2012-09-04 17:50:00 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Installation
|
2012-09-04 17:50:00 +00:00
|
|
|
sudo apt-get install nginx
|
2012-08-26 14:18:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Site Configuration
|
|
|
|
|
|
|
|
Download an example site config:
|
|
|
|
|
2012-09-04 16:44:17 +00:00
|
|
|
sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/nginx/gitlab -P /etc/nginx/sites-available/
|
2012-09-02 16:31:16 +00:00
|
|
|
sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Make sure to edit the config file to match your setup:
|
|
|
|
|
2012-09-02 16:31:16 +00:00
|
|
|
# Change **YOUR_SERVER_IP** and **YOUR_SERVER_FQDN**
|
|
|
|
# to the IP address and fully-qualified domain name
|
2012-12-05 19:34:11 +00:00
|
|
|
# of your host serving GitLab
|
2012-09-02 16:31:16 +00:00
|
|
|
sudo vim /etc/nginx/sites-enabled/gitlab
|
2012-03-13 18:19:03 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Restart
|
|
|
|
|
2012-10-07 00:36:20 +00:00
|
|
|
sudo /etc/init.d/nginx restart
|
2012-03-13 18:19:03 +00:00
|
|
|
|
2012-09-04 17:50:00 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# Done!
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
Visit YOUR_SERVER for your first GitLab login.
|
|
|
|
The setup has created an admin account for you. You can use it to log in:
|
2012-03-12 12:51:21 +00:00
|
|
|
|
2012-08-02 12:30:22 +00:00
|
|
|
admin@local.host
|
|
|
|
5iveL!fe
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
**Important Note**
|
|
|
|
Please go over to your profile page and immediately chage the password, so
|
|
|
|
nobody can access your GitLab by using this login information later on.
|
|
|
|
|
|
|
|
**Enjoy!**
|
|
|
|
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-10-25 08:13:11 +00:00
|
|
|
- - -
|
|
|
|
|
2012-03-12 12:47:57 +00:00
|
|
|
|
2012-10-24 17:42:55 +00:00
|
|
|
# Advanced setup tips:
|
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
## Custom Redis connections
|
2012-09-19 01:53:27 +00:00
|
|
|
|
|
|
|
If you'd like Resque to connect to a Redis server on a non-standard port or on
|
2012-12-05 19:34:11 +00:00
|
|
|
a different host, you can configure its connection string via the
|
|
|
|
`config/resque.yml` file.
|
2012-03-13 22:07:13 +00:00
|
|
|
|
2012-12-05 19:34:11 +00:00
|
|
|
# example
|
|
|
|
production: redis.example.tld:6379
|