Support #679
Updated by Daniel Curtis about 9 years ago
This is a guide on installing GitLab 8 on FreeBSD 10.
h2. Prepare the Environment
* Make sure the system is up to date:
<pre>
pkg update && pkg upgrade
</pre>
* Install a few dependencies:
<pre>
pkg install sudo bash icu cmake pkgconf git node ruby ruby21-gems logrotate postfix krb5 go wget rubygem-bundler portmaster
</pre>
* Add the GitLab user
<pre>
pw add user -n git -m -s /usr/local/bin/bash -c "GitLab"
</pre>
* Install a couple gems:
<pre>
gem install whenever rubocop
</pre>
h2. Install PostgreSQL
* Install postgresql94-server:
<pre>
pkg install postgresql94-server
</pre>
* Start and enable postgresql at boot:
<pre>
echo 'postgresql_enable="YES"' >> /etc/rc.conf
service postgresql start
</pre>
Set up the database:
* Log in to postgresql user account
<pre>
su - pgsql
</pre>
* Initialise postgresql database
<pre>
initdb /usr/local/pgsql/data
</pre>
* Connect to postgresql database
<pre>
psql -d template1
</pre>
#* Create a user for GitLab:
<pre>
CREATE USER git CREATEDB;
</pre>
#* Create the GitLab production database & grant all privileges on database
<pre>
CREATE DATABASE gitlabhq_production OWNER git encoding='UTF8';
</pre>
#* Quit the database session
<pre>
\q
</pre>
h2. Install Redis
* Install redis:
<pre>
pkg install redis
</pre>
* Back up the original Redis config file:
<pre>
cp /usr/local/etc/redis.conf /usr/local/etc/redis.conf.orig
</pre>
* Disable Redis listening on TCP by setting 'port' to 0
<pre>
sed 's/^port .*/port 0/' /usr/local/etc/redis.conf.orig | sudo tee /usr/local/etc/redis.conf
</pre>
* Enable Redis socket
<pre>
echo 'unixsocket /usr/local/var/run/redis/redis.sock' | sudo tee -a /usr/local/etc/redis.conf
</pre>
* Grant permission to the socket to all members of the redis group
<pre>
echo 'unixsocketperm 770' | sudo tee -a /usr/local/etc/redis.conf
</pre>
* Create the directory which contains the socket
<pre>
mkdir -p /usr/local/var/run/redis
chown redis:redis /usr/local/var/run/redis
chmod 755 /usr/local/var/run/redis
</pre>
* Start and enable redis at boot:
<pre>
echo 'redis_enable="YES"' >> /etc/rc.conf
service redis restart
</pre>
h2. Install GitLab 8
* Switch to the git user:
<pre>
su - git
</pre>
* Clone GitLab repository
<pre>
git clone https://gitlab.com/gitlab-org/gitlab-ce.git -b 8-1-stable gitlab
</pre>
* Switch to the GitLab installation folder
<pre>
cd /home/git/gitlab
</pre>
* Copy the example GitLab config
<pre>
cp config/gitlab.yml.example config/gitlab.yml
</pre>
* Update GitLab config file, follow the directions at top of file
<pre>
vi config/gitlab.yml
</pre>
* Copy the example secrets file
<pre>
cp config/secrets.yml.example config/secrets.yml
chmod 0600 config/secrets.yml
</pre>
* Make sure GitLab can write to the log/ and tmp/ directories
<pre>
chown -R git log/
chown -R git tmp/
chmod -R u+rwX,go-w log/
chmod -R u+rwX tmp/
</pre>
* Make sure GitLab can write to the tmp/pids/ and tmp/sockets/ directories
<pre>
chmod -R u+rwX tmp/pids/
chmod -R u+rwX tmp/sockets/
</pre>
* Make sure GitLab can write to the public/uploads/ directory
<pre>
chmod -R u+rwX public/uploads
</pre>
* Change the permissions of the directory where CI build traces are stored
<pre>
chmod -R u+rwX builds/
</pre>
* Copy the example Unicorn config
<pre>
cp config/unicorn.rb.example config/unicorn.rb
</pre>
* Copy the example Rack attack config
<pre>
cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb
</pre>
* Configure Git global settings for git user, used when editing via web editor
<pre>
git config --global core.autocrlf input
</pre>
* Configure Redis connection settings
<pre>
cp config/resque.yml.example config/resque.yml
</pre>
* Change the Redis socket path if you are not using the default Debian / Ubuntu configuration
<pre>
vi config/resque.yml
</pre>
#* And modify the following parameter:
<pre>
production: unix:/usr/local/var/run/redis/redis.sock
</pre>
* Configure GitLab DB Settings:
<pre>
cp config/database.yml.postgresql config/database.yml
</pre>
* Change the database credentials
<pre>
vi config/database.yml
</pre>
* Make config/database.yml readable to git only
<pre>
chmod o-rwx config/database.yml
</pre>
* Install the gems for PostgreSQL:
<pre>
bundle install --deployment --without development test mysql aws kerberos
</pre>
h3. Install GitLab Shell
* Run the installation task for gitlab-shell:
<pre>
bundle exec rake gitlab:shell:install[v2.6.5] REDIS_URL=unix:/var/run/redis/redis.sock RAILS_ENV=production
</pre>
# By default, the gitlab-shell config is generated from your main GitLab config, double check the settings are correct:
<pre>
vi /home/git/gitlab-shell/config.yml
</pre>
h3. Install GitLab HTTP Server
* Install the gitlab http server:
<pre>
cd /home/git
git clone https://gitlab.com/gitlab-org/gitlab-git-http-server.git
cd gitlab-git-http-server
git checkout 0.3.0
make
</pre>
h3. Initialize Database
* Initialize the database:
<pre>
bundle exec rake gitlab:setup RAILS_ENV=production
</pre>
h3. Install schedules
* Install whenenver:
<pre>
cd /home/git/gitlab
echo "gem 'whenever', '~> 0.9.3'" >> Gemfile
bundle install --no-deployment --path vendor/bundle
bundle install --deployment --without development test mysql aws kerberos
</pre>
* Setup schedules
<pre>
bundle exec whenever -w RAILS_ENV=production
</pre>
h3. Install Init Script
* Exit out of the git user, back into root:
<pre>
exit
</pre>
* Download the init script:
<pre>
wget -O /usr/local/etc/rc.d/gitlab https://gitlab.com/gitlab-org/gitlab-recipes/raw/master/init/init/freebsd/gitlab-unicorn
</pre>
* Make the init script executable:
<pre>
chmod +x /usr/local/etc/rc.d/gitlab
</pre>
h3. Check Configuration and Compile Assets
* Check the configuration:
<pre>
cd /home/git/gitlab
bundle exec rake gitlab:env:info RAILS_ENV=production
</pre>
* Compile all of the assets for GitLab:
<pre>
bundle exec rake assets:precompile RAILS_ENV=production
</pre>
* Start and enable gitlab at boot:
<pre>
echo 'gitlab_enable="YES"' >> /etc/rc.conf
service gitlab start
</pre>
h2. Install Nginx
* Install nginx:
<pre>
portmaster www/nginx
</pre>
*NOTE*: Make sure to enable *[X]HTTP_GZIP_STATIC* during the nginx configuration
* Start and enable nginx at boot:
<pre>
echo 'nginx_enable="YES"' >> /etc/rc.conf
service nginx start
</pre>
* Create a configuration directory to make managing individual server blocks easier
<pre>
mkdir /usr/local/etc/nginx/conf.d
</pre>
* Edit the main nginx config file:
<pre>
vi /usr/local/etc/nginx/nginx.conf
</pre>
#* And strip down the config file and add the include statement at the end to make it easier to handle various server blocks:
<pre>
#user nobody;
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;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
# Load config files from the /etc/nginx/conf.d directory
include /usr/local/etc/nginx/conf.d/*.conf;
}
</pre>
* Create the gitlab nginx config:
<pre>
vi /usr/local/etc/nginx/conf.d/gitlab.conf
</pre>
#* And add the following:
<pre>
upstream gitlab {
server unix:/home/git/gitlab/tmp/sockets/gitlab.socket fail_timeout=0;
}
upstream gitlab-git-http-server {
server unix:/home/git/gitlab/tmp/sockets/gitlab-git-http-server.socket fail_timeout=0;
}
server {
listen 0.0.0.0:80 default_server;
server_name gitlab.example.com;
server_tokens off;
root /home/git/gitlab/public;
client_max_body_size 20m;
access_log /var/log/gitlab_access.log;
error_log /var/log/gitlab_error.log;
location / {
try_files $uri $uri/index.html $uri.html @gitlab;
}
location /uploads/ {
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
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_set_header X-Frame-Options SAMEORIGIN;
proxy_pass http://gitlab;
}
location @gitlab {
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
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_set_header X-Frame-Options SAMEORIGIN;
proxy_pass http://gitlab;
}
location ~ ^/[\w\.-]+/[\w\.-]+/(info/refs|git-upload-pack|git-receive-pack)$ {
error_page 418 = @gitlab-git-http-server;
return 418;
}
location ~ ^/[\w\.-]+/[\w\.-]+/repository/archive {
error_page 418 = @gitlab-git-http-server;
return 418;
}
location ~ ^/api/v3/projects/.*/repository/archive {
error_page 418 = @gitlab-git-http-server;
return 418;
}
location @gitlab-git-http-server {
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
proxy_buffering off;
proxy_request_buffering 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-git-http-server;
}
location ~ ^/(assets)/ {
root /home/git/gitlab/public;
gzip_static on;
expires max;
add_header Cache-Control public;
}
error_page 502 /502.html;
}
</pre>
h2. Resources
* http://doc.gitlab.com/ce/install/installation.html
* https://github.com/gitlabhq/gitlab-recipes/blob/master/install/freebsd/freebsd-10.md