Giter VIP home page Giter VIP logo

installation-guide-for-gitlab-on-os-x's Introduction

Installation guide for GitLab 6.3 on OS X 10.9 with Server 3

Requirements

  • Mac OS X 10.9
  • Server 3
  • User group git and user git in this group
  • Enable remote login for git user
  • Installed Xcode

Hide the git user from the login screen:

 sudo defaults write /Library/Preferences/com.apple.loginwindow HiddenUsersList -array-add git

Unhide:

sudo defaults delete /Library/Preferences/com.apple.loginwindow HiddenUsersList

Recommendation

Use Parallels Deskop for first install.

Note

If you find any issues, please let me know or send PR with fix ;-) Thank you!

Install instructions

  1. Install Homebrew
  2. Install some prerequisites
  3. Install mysql
  4. Setup database
  5. Install ruby
  6. Install Gitlab Shell
  7. Install GitLab
  8. Check Installation
  9. Setting up Gitlab with Apache
  10. Automatic backups

1. Install Homebrew

ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
brew doctor

2. Install some prerequisites

xcode-select --install #xcode command line tools

brew install icu4c git logrotate redis libxml2

ln -sfv /usr/local/opt/logrotate/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.logrotate.plist
ln -sfv /usr/local/opt/redis/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.redis.plist

Make sure you have python 2.5+ (gitlab don’t support python 3.x)

Confirm python 2.5+

python --version

GitLab looks for python2

sudo ln -s /usr/bin/python /usr/bin/python2

Some more dependices

sudo easy_install pip
sudo pip install pygments

Install docutils from http://sourceforge.net/projects/docutils/files/latest/download?source=files

curl -O http://heanet.dl.sourceforge.net/project/docutils/docutils/0.11/docutils-0.11.tar.gz
gunzip -c docutils-0.11.tar.gz | tar xopf -
cd docutils-0.11
sudo python setup.py install

3. Install mysql

brew install mysql
ln -sfv /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist

4. Setup database

Run mysql_secure_installation and set a reoot password, disallow remote root login, remove the test database, and reload the privelege tables.

mysql_secure_installation

Now login in mysql

mysql -u root -pPASSWORD_HERE

Create a new user for our gitlab setup 'gitlab'

CREATE USER 'gitlab'@'localhost' IDENTIFIED BY 'PASSWORD_HERE';

Create database

CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;

Grant the GitLab user necessary permissions on the table.

GRANT SELECT, LOCK TABLES, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost';

Quit the database session

\q

Try connecting to the new database with the new user

sudo -u git -H mysql -u gitlab -pPASSWORD_HERE -D gitlabhq_production

5. Install ruby

OS X 10.9 has ruby 2.0. No need to install anything.

6. Install Gitlab Shell

cd /Users/git
sudo -u git git clone https://github.com/gitlabhq/gitlab-shell.git
cd gitlab-shell
sudo -u git git checkout v1.7.9
sudo -u git cp config.yml.example config.yml

Now open config.yml file and edit it

Set the gitlab_url. Replace gitlab.example.com wih your url (domain.com)

sudo -u git sed -i "" "s/localhost/domain.com/" config.yml

Use /Users instead of /home, and change redis-cli path to homebrew’s redis-cli

sudo -u git sed -i "" "s/\/home\//\/Users\//g" config.yml
sudo -u git sed -i "" "s/\/usr\/bin\/redis-cli/\/usr\/local\/bin\/redis-cli/" config.yml

Do setup

sudo -u git -H ./bin/install

7. Install Gitlab

Download Gitlab

cd /Users/git
sudo -u git git clone https://github.com/gitlabhq/gitlabhq.git gitlab
cd gitlab
sudo -u git git checkout 6-3-stable

Configuring GitLab

sudo -u git cp config/gitlab.yml.example config/gitlab.yml
sudo -u git sed -i "" "s/\/usr\/bin\/git/\/usr\/local\/bin\/git/g" config/gitlab.yml
sudo -u git sed -i "" "s/\/home/\/Users/g" config/gitlab.yml
sudo -u git sed -i "" "s/localhost/domain.com/g" config/gitlab.yml

Make sure GitLab can write to the log/ and tmp/ directories

sudo chown -R git log/
sudo chown -R git tmp/
sudo chmod -R u+rwX  log/
sudo chmod -R u+rwX  tmp/

Create directories for repositories make sure GitLab can write to them

sudo -u git mkdir /Users/git/repositories
sudo chmod -R u+rwX  /Users/git/repositories/

Create directory for satellites

sudo -u git mkdir /Users/git/gitlab-satellites

Create directories for sockets/pids and make sure GitLab can write to them

sudo -u git mkdir tmp/pids/
sudo -u git mkdir tmp/sockets/

sudo chmod -R u+rwX  tmp/pids/
sudo chmod -R u+rwX  tmp/sockets/

Create public/uploads directory otherwise backup will fail

sudo -u git mkdir public/uploads
sudo chmod -R u+rwX  public/uploads

Fix

sudo chown -R git:git /Users/git/repositories/
sudo chmod -R ug+rwX,o-rwx /Users/git/repositories/
sudo chmod -R ug-s /Users/git/repositories/
sudo find /Users/git/repositories/ -type d -print0 | sudo xargs -0 chmod g+s

Copy the example Unicorn config

sudo -u git cp config/unicorn.rb.example config/unicorn.rb
sudo -u git sed -i "" "s/\/home/\/Users/g" config/unicorn.rb

Comment out listen "/Users/git/gitlab/tmp/sockets/gitlab.socket", :backlog => 64 in unicorn.rb.

Configure Git global settings for git user, useful when editing via web

sudo -u git -H git config --global user.name "GitLab"
sudo -u git -H git config --global user.email "[email protected]"

Copy rack attack middleware config

sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb

Uncomment config.middleware.use Rack::Attack in /Users/git/gitlab/config/application.rb

Set up logrotate

sudo mkdir /etc/logrotate.d/
sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab
sudo sed -i "" "s/\/home/\/Users/g" /etc/logrotate.d/gitlab

Gitlab Mysql Config

sudo -u git cp config/database.yml.mysql config/database.yml
sudo -u git sed -i "" "s/root/gitlab/g" config/database.yml
sudo -u git sed -i "" "s/secure password/PASSWORD_HERE/g" config/database.yml

Install Gems

You need to edit Gemfile.lock (sudo -u git nano Gemfile.lock) and change the versions of libv8 to 3.16.14.3 (in two places), therubyracer to 0.12.0 and underscore-rails to 1.5.2 (in two places). You also need to edit Gemfile (sudo -u git nano Gemfile) to change underscore-rails to 1.5.2.

sudo gem install bundler
sudo gem install charlock_holmes --version '0.6.9.4'
sudo bundle install --deployment --without development test postgres aws

Initialize Database and Activate Advanced Features

sudo -u git -H bash -l -c 'bundle exec rake gitlab:setup RAILS_ENV=production'

Here is your admin login credentials:

login: [email protected]
password: 5iveL!fe

Install Init script

sudo mkdir /etc/init.d
sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
sudo chmod +x /etc/init.d/gitlab
sudo sed -i "" "s/\/home\//\/Users\//g" /etc/init.d/gitlab
sudo /etc/init.d/gitlab start

8. Check Installation

Check gitlab-shell

sudo -u git /Users/git/gitlab-shell/bin/check

Double-check environment configuration

sudo -u git -H bash -l -c 'bundle exec rake gitlab:env:info RAILS_ENV=production'

Do a thorough check. Make sure everything is green.

sudo -u git -H bash -l -c 'bundle exec rake gitlab:check RAILS_ENV=production'

The script complained about the init script not being up-to-date, but I assume that’s because it was modified to use /Users instead of /home. You can safely ignore that warning.

9. Setting up Gitlab with Apache

  1. Setup website in Server.app (with SSL)
  2. Go to /Library/Server/Web/Config/apache2/sites
  3. Stop the webserver
  4. Edit your site config, for example 0000_any_443_domain.com.conf, like vhost config in this repo.
  5. Start the webserver

10. Automatic backups

Copy com.webentity.gitlab_backup.plist to /Library/LaunchDaemons/ and setup it.

sudo cp com.webentity.gitlab_backup.plist /Library/LaunchDaemons/
sudo launchctl load /Library/LaunchDaemons/com.webentity.gitlab_backup.plist

I recomend to uncomment keep_time in gitlab.yml Backup settings.

ToDo

  • LaunchDaemon for GitLab (com.webentity.gitlab.plist in this repo does not work - maybe /etc/init.d/gitlab need some tweaks)

Links and sources ( thank you guys :-) )

installation-guide-for-gitlab-on-os-x's People

Contributors

jacopotarantino avatar zshannon avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.