Project

General

Profile

Support #814

Install GitLab 8 on FreeBSD

Added by Daniel Curtis over 4 years ago. Updated almost 4 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
Source Code Management
Target version:
Start date:
05/24/2016
Due date:
% Done:

100%

Estimated time:
2.00 h
Spent time:

Description

This is a guide on installing GitLab 8.5 with continuous integration on FreeBSD 10.

Prepare the Environment

  • Make sure the system is up to date:
    pkg update && pkg upgrade
    

Install PostgreSQL

  • Install postgresql:
    pkg install postgresql94-server
    
  • Initialize, start, and enable postgresql at boot:
    echo 'postgresql_enable="YES"' >> /etc/rc.conf
    service postgresql initdb
    service postgresql start
    
  • Log in to postgresql user account
    su - pgsql
    
  • Connect to postgresql database
    psql -d template1
    
    • Create a user for GitLab:
      CREATE USER git WITH PASSWORD 'SuperSecretPassword' CREATEDB SUPERUSER;
      
    • Create the GitLab production database & grant all privileges on database
      CREATE DATABASE gitlabhq_production OWNER git encoding='UTF8';
      
    • Quit the database session
      \q
      exit
      

Install Redis

  • Install redis:
    pkg install redis
    
  • Back up the original Redis config file:
    cp /usr/local/etc/redis.conf /usr/local/etc/redis.conf.orig
    
  • Disable Redis listening on TCP by setting 'port' to 0
    sed -i '' -e 's/^port .*/port 0/' /usr/local/etc/redis.conf
    
  • Enable Redis socket
    echo 'unixsocket /var/run/redis/redis.sock' >> /usr/local/etc/redis.conf
    
  • Grant permission to the socket to all members of the redis group
    echo 'unixsocketperm 770' >> /usr/local/etc/redis.conf
    
  • Create the directory which contains the socket
    mkdir -p /var/run/redis
    chown redis:redis /var/run/redis
    chmod 755 /var/run/redis
    
  • Start and enable redis at boot:
    echo 'redis_enable="YES"' >> /etc/rc.conf
    service redis start
    

Install GitLab 8

  • Install gitlab:
    pkg install gitlab
    
  • Add git user to redis group
    pw groupmod redis -m git
    
  • Go to GitLab installation folder
    cd /usr/local/www/gitlab
    
  • Update GitLab config file, follow the directions at the top of the file
    vi config/gitlab.yml
    
  • Find number of cores
    sysctl hw.ncpu
    
  • Enable cluster mode if you expect to have a high load instance, set the number of workers to at least the number of cores:
    vi config/unicorn.rb
    
  • Edit the gitlab-shell config file:
    vi /usr/local/share/gitlab-shell/config.yml
    
    • And make sure the following configuration parameters are set:
      repos_path: "/usr/home/git/repositories" 
      
      redis:
        bin: /usr/local/bin/redis-cli
      
  • Create the uploads directory and harden its permissions:
    sudo -u git mkdir /usr/local/www/gitlab/public/uploads
    chmod 700 /usr/local/www/gitlab/public/uploads
    
  • Configure Git global settings for git user:
    git config --global core.autocrlf input
    
  • Disable 'git gc --auto' because GitLab already runs 'git gc' when needed:
    git config --global gc.auto 0
    
  • Configure GitLab DB settings
    vi config/database.yml
    
  • Initialize database and activate advanced features:
    rake gitlab:setup RAILS_ENV=production
    
    1. Type yes to create the database tables.
    2. When done you see Administrator account created:
  • Check if GitLab and its environment are configured correctly:
    rake gitlab:env:info RAILS_ENV=production
    
  • Compile Assets
    rake assets:precompile RAILS_ENV=production
    
  • Start and enable gitlab at boot:
    echo 'gitlab_enable="YES"' >> /etc/rc.conf
    service gitlab start
    

Generate SSH keys

  • Switch to the gitlab user:
    su - git
    
  • Generate an SSH key pair:
    shs-keygen -t ed25519
    
  • And link the .ssh folder into the git home directory:
    ln -s /usr/local/git/.ssh /home/git/
    

Install Nginx

  • Install nginx:
    pkg install nginx
    
  • Start and enable nginx at boot:
    echo 'nginx_enable="YES"' >> /etc/rc.conf
    service nginx start
    
  • Create a configuration directory to make managing individual server blocks easier
    mkdir /usr/local/etc/nginx/conf.d
    
  • Edit the main nginx config file:
    vi /usr/local/etc/nginx/nginx.conf
    
    • And strip down the config file and add the include statement at the end to make it easier to handle various server blocks:
      worker_processes  1;
      error_log  /var/log/nginx-error.log;
      
      events {
          worker_connections  1024;
      }
      
      http {
          include       mime.types;
          default_type  application/octet-stream;
          sendfile        on;
          keepalive_timeout  65;
      
          # Load config files from the /etc/nginx/conf.d directory
          include /usr/local/etc/nginx/conf.d/*.conf;
      }
      
  • Create the gitlab nginx config:
    vi /usr/local/etc/nginx/conf.d/gitlab.example.com.conf
    
    • And add the following:
      upstream gitlab-workhorse {
        server unix:/usr/local/www/gitlab/tmp/sockets/gitlab-workhorse.socket fail_timeout=0;
      }
      
      server {
        listen 80;
        server_name gitlab.example.com;
        server_tokens off;
        root /usr/local/www/gitlab/public;
        access_log  /var/log/gitlab.example.com-access.log;
        error_log   /var/log/gitlab.example.com-error.log;
      
        location / {
          client_max_body_size 0;
          gzip off;
      
          proxy_read_timeout      300;
          proxy_connect_timeout   300;
          proxy_redirect          off;
      
          proxy_http_version 1.1;
      
          proxy_set_header    Host                $http_host;
          proxy_set_header    X-Real-IP           $remote_addr;
          proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
          proxy_set_header    X-Forwarded-Proto   $scheme;
      
          proxy_pass http://gitlab-workhorse;
        }
      }
      

Resources

History

#1 Updated by Daniel Curtis over 4 years ago

  • % Done changed from 0 to 30
  • Description updated (diff)
  • Status changed from New to In Progress

#2 Updated by Daniel Curtis over 4 years ago

  • Description updated (diff)

#3 Updated by Daniel Curtis over 4 years ago

  • % Done changed from 30 to 100
  • Description updated (diff)
  • Status changed from In Progress to Resolved

#4 Updated by Daniel Curtis over 4 years ago

  • Description updated (diff)

#5 Updated by Daniel Curtis over 4 years ago

  • Description updated (diff)

#6 Updated by Daniel Curtis about 4 years ago

  • Status changed from Resolved to Closed

#7 Updated by Daniel Curtis almost 4 years ago

  • Description updated (diff)

Also available in: Atom PDF