Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kazuhiko Shiozaki
gitlab-ce
Commits
5c649266
Commit
5c649266
authored
Feb 04, 2013
by
Dmitriy Zaporozhets
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
update installation docs
parent
27d9ac0f
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
36 additions
and
90 deletions
+36
-90
doc/install/installation.md
doc/install/installation.md
+36
-90
No files found.
doc/install/installation.md
View file @
5c649266
...
@@ -90,86 +90,32 @@ Install the Bundler Gem:
...
@@ -90,86 +90,32 @@ Install the Bundler Gem:
# 3. System Users
# 3. System Users
Create a
user for Git and Gitolite
:
Create a
`git`
user for Gitlab
:
sudo adduser \
sudo adduser --disabled-login --gecos 'GitLab' git
--system \
--shell /bin/sh \
--gecos 'Git Version Control' \
--group \
--disabled-password \
--home /home/git \
git
Create a user for GitLab:
# 4. GitLab shell
sudo adduser --disabled-login --gecos 'GitLab' gitlab
# login as git
sudo su git
# Add it to the git group
sudo usermod -a -G git gitlab
# Generate the SSH key
sudo -u gitlab -H ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa
# 4. Gitolite
Clone GitLab's fork of the Gitolite source code:
# go to home directory
cd /home/git
cd /home/git
sudo -u git -H git clone -b gl-v320 https://github.com/gitlabhq/gitolite.git /home/git/gitolite
Setup Gitolite with GitLab as its admin:
**Important Note:**
GitLab assumes
*full and unshared*
control over this Gitolite installation.
# Add Gitolite scripts to $PATH
sudo -u git -H mkdir /home/git/bin
sudo -u git -H sh -c 'printf "%b\n%b\n" "PATH=\$PATH:/home/git/bin" "export PATH" >> /home/git/.profile'
sudo -u git -H sh -c 'gitolite/install -ln /home/git/bin'
# Copy the gitlab user's (public) SSH key ...
sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub
sudo chmod 0444 /home/git/gitlab.pub
#
... and use it as the admin key for the Gitolite setup
#
clone gitlab shell
sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gitolite setup -pk /home/git/gitlab.pub"
git clone https://dzaporozhets@dev.gitlab.org/gitlab/gitlab-shell.git
Fix the directory permissions for the configuration directory:
# setup
cd gitlab-shell
# Make sure the Gitolite config dir is owned by git
cp config.yml.example config.yml
sudo chmod 750 /home/git/.gitolite/
./bin/install
sudo chown -R git:git /home/git/.gitolite/
Fix the directory permissions for the repositories:
# Make sure the repositories dir is owned by git and it stays that way
sudo chmod -R ug+rwX,o-rwx /home/git/repositories/
sudo chown -R git:git /home/git/repositories/
find /home/git/repositories -type d -print0 | sudo xargs -0 chmod g+s
## Add domains to list to the list of known hosts
## Add domains to list to the list of known hosts
sudo -u gitlab -H ssh git@localhost
sudo -u git -H ssh git@localhost
sudo -u gitlab -H ssh git@YOUR_DOMAIN_NAME
sudo -u git -H ssh git@YOUR_DOMAIN_NAME
sudo -u gitlab -H ssh git@YOUR_GITOLITE_DOMAIN_NAME
sudo -u git -H ssh git@YOUR_GITOLITE_DOMAIN_NAME
## 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
sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin
# If it succeeded without errors you can remove the cloned repo
sudo rm -rf /tmp/gitolite-admin
**Important Note:**
If you can't clone the
`gitolite-admin`
repository:
**DO NOT PROCEED WITH INSTALLATION**
!
Check the
[
Trouble Shooting Guide
](
https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide
)
and make sure you have followed all of the above steps carefully.
# 5. Database
# 5. Database
...
@@ -179,19 +125,19 @@ See `doc/install/databases.md`
...
@@ -179,19 +125,19 @@ See `doc/install/databases.md`
# 6. GitLab
# 6. GitLab
# We'll install GitLab into home directory of the user "git
lab
"
# We'll install GitLab into home directory of the user "git"
cd /home/git
lab
cd /home/git
## Clone the Source
## Clone the Source
# Clone GitLab repository
# Clone GitLab repository
sudo -u git
lab
-H git clone https://github.com/gitlabhq/gitlabhq.git gitlab
sudo -u git -H git clone https://github.com/gitlabhq/gitlabhq.git gitlab
# Go to gitlab dir
# Go to gitlab dir
cd /home/git
lab
/gitlab
cd /home/git/gitlab
# Checkout to stable release
# Checkout to stable release
sudo -u git
lab
-H git checkout 4-1-stable
sudo -u git -H git checkout 4-1-stable
**Note:**
**Note:**
You can change
`4-1-stable`
to
`master`
if you want the
*bleeding edge*
version, but
You can change
`4-1-stable`
to
`master`
if you want the
*bleeding edge*
version, but
...
@@ -199,14 +145,14 @@ do so with caution!
...
@@ -199,14 +145,14 @@ do so with caution!
## Configure it
## Configure it
cd /home/git
lab
/gitlab
cd /home/git/gitlab
# Copy the example GitLab config
# Copy the example GitLab config
sudo -u git
lab
-H cp config/gitlab.yml.example config/gitlab.yml
sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml
# Make sure to change "localhost" to the fully-qualified domain name of your
# Make sure to change "localhost" to the fully-qualified domain name of your
# host serving GitLab where necessary
# host serving GitLab where necessary
sudo -u git
lab
-H vim config/gitlab.yml
sudo -u git -H vim config/gitlab.yml
# Make sure GitLab can write to the log/ and tmp/ directories
# Make sure GitLab can write to the log/ and tmp/ directories
sudo chown -R gitlab log/
sudo chown -R gitlab log/
...
@@ -215,10 +161,10 @@ do so with caution!
...
@@ -215,10 +161,10 @@ do so with caution!
sudo chmod -R u+rwX tmp/
sudo chmod -R u+rwX tmp/
# Make directory for satellites
# Make directory for satellites
sudo -u git
lab -H mkdir /home/gitlab
/gitlab-satellites
sudo -u git
-H mkdir /home/git
/gitlab-satellites
# Copy the example Unicorn config
# Copy the example Unicorn config
sudo -u git
lab
-H cp config/unicorn.rb.example config/unicorn.rb
sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb
**Important Note:**
**Important Note:**
Make sure to edit both files to match your setup.
Make sure to edit both files to match your setup.
...
@@ -226,24 +172,24 @@ Make sure to edit both files to match your setup.
...
@@ -226,24 +172,24 @@ Make sure to edit both files to match your setup.
## Configure GitLab DB settings
## Configure GitLab DB settings
# Mysql
# Mysql
sudo -u git
lab
cp config/database.yml.mysql config/database.yml
sudo -u git cp config/database.yml.mysql config/database.yml
# PostgreSQL
# PostgreSQL
sudo -u git
lab
cp config/database.yml.postgresql config/database.yml
sudo -u git cp config/database.yml.postgresql config/database.yml
Make sure to update username/password in config/database.yml.
Make sure to update username/password in config/database.yml.
## Install Gems
## Install Gems
cd /home/git
lab
/gitlab
cd /home/git/gitlab
sudo gem install charlock_holmes --version '0.6.9'
sudo gem install charlock_holmes --version '0.6.9'
# For MySQL (note, the option says "without")
# For MySQL (note, the option says "without")
sudo -u git
lab
-H bundle install --deployment --without development test postgres
sudo -u git -H bundle install --deployment --without development test postgres
# Or for PostgreSQL
# Or for PostgreSQL
sudo -u git
lab
-H bundle install --deployment --without development test mysql
sudo -u git -H bundle install --deployment --without development test mysql
## Configure Git
## Configure Git
...
@@ -251,8 +197,8 @@ GitLab needs to be able to commit and push changes to Gitolite. In order to do
...
@@ -251,8 +197,8 @@ GitLab needs to be able to commit and push changes to Gitolite. In order to do
that Git requires a username and email. (We recommend using the same address
that Git requires a username and email. (We recommend using the same address
used for the
`email.from`
setting in
`config/gitlab.yml`
)
used for the
`email.from`
setting in
`config/gitlab.yml`
)
sudo -u git
lab
-H git config --global user.name "GitLab"
sudo -u git -H git config --global user.name "GitLab"
sudo -u git
lab
-H git config --global user.email "gitlab@localhost"
sudo -u git -H git config --global user.email "gitlab@localhost"
## Setup GitLab Hooks
## Setup GitLab Hooks
...
@@ -261,7 +207,7 @@ used for the `email.from` setting in `config/gitlab.yml`)
...
@@ -261,7 +207,7 @@ used for the `email.from` setting in `config/gitlab.yml`)
## Initialise Database and Activate Advanced Features
## Initialise Database and Activate Advanced Features
sudo -u git
lab
-H bundle exec rake gitlab:setup RAILS_ENV=production
sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production
## Install Init Script
## Install Init Script
...
@@ -280,11 +226,11 @@ Make GitLab start on boot:
...
@@ -280,11 +226,11 @@ Make GitLab start on boot:
Check if GitLab and its environment is configured correctly:
Check if GitLab and its environment is configured correctly:
sudo -u git
lab
-H bundle exec rake gitlab:env:info RAILS_ENV=production
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
To make sure you didn't miss anything run a more thorough check with:
To make sure you didn't miss anything run a more thorough check with:
sudo -u git
lab
-H bundle exec rake gitlab:check RAILS_ENV=production
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
If all items are green, then congratulations on successfully installing GitLab!
If all items are green, then congratulations on successfully installing GitLab!
However there are still a few steps left.
However there are still a few steps left.
...
@@ -357,7 +303,7 @@ a different host, you can configure its connection string via the
...
@@ -357,7 +303,7 @@ a different host, you can configure its connection string via the
If you are running SSH on a non-standard port, you must change the gitlab user'S SSH config.
If you are running SSH on a non-standard port, you must change the gitlab user'S SSH config.
# Add to /home/git
lab
/.ssh/config
# Add to /home/git/.ssh/config
host localhost # Give your setup a name (here: override localhost)
host localhost # Give your setup a name (here: override localhost)
user git # Your remote git user
user git # Your remote git user
port 2222 # Your port number
port 2222 # Your port number
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment