Skip to main content

Setup Self-hosted Instance

Commands​

service gitlab restart
gitlab-ctl reconfigure
gitlab-ctl start
gitlab-ctl stop

Installation​

OS​

The recommended operating system is Linux Debian 10 (buster) distribution.

Prerequisites​

Install required packages:

apt-get update && \
    apt-get install \
    cron \
    curl \
    ca-certificates \
    openssh-server \
    wget \
    apt-transport-https \
    vim \
    tzdata \
    nano \
    less \
    net-tools

Enable SSH and modify key PermitRootLogin yes:

nano /etc/ssh/sshd_config

Restart SSH service for changes to take effect:

service sshd restart

Installer​

GitLab-ee

Install package:

sudo dpkg -i gitlab-ee_xx.x.x-ee.0_amd64.deb

SSH files​

/etc/ssh

Copy SSH keys from one server to another server

CONFIG TEMPLATE​

/etc/gitlab.rb

Stop GitLab services by executing gitlab-ctl stop command before making and saving changes.\ Execute gitlab-ctl reconfigure command to commit changes.

OMNIBUS CONFIG README​

Nginx​

Config file​

/var/opt/gitlab/nginx/conf/nginx.conf

nginx['custom_nginx_config'] = "include /etc/nginx/conf.d/*.conf;"

Server block custom_gitlab_server_config.conf​

nginx['custom_gitlab_server_config'] = "include /etc/gitlab/custom_gitlab_server_config.conf;"
nginx['custom_gitlab_server_config'] = "location ^~ /foo-namespace/bar-project/raw/ {\n deny all;\n}\n"

Allow/deny access​

/var/opt/gitlab/nginx/conf/gitlab-http.conf

allow 192.168.1.1/24;
deny all;

location ~ /.well-known {
    allow all;
}

Instance access settings​

external_url 'hostname'
nginx['listen_port'] = 80
nginx['redirect_http_to_https'] = false
nginx['listen_https'] = false
gitlab_rails['gitlab_shell_ssh_port'] = 22

Instance settings​

redis['tcp_keepalive'] = '300'
nginx['gzip_enabled'] = true
gitlab_rails['gitlab_default_projects_features_builds'] = false

Backup settings​

gitlab_rails['backup_archive_permissions'] = 0644
gitlab_rails['backup_path'] = '/var/opt/gitlab/backups'
gitlab_rails['backup_upload_connection'] = {
 :provider => 'Local',
 :local_root => '/var/backups'
}
gitlab_rails['backup_upload_remote_directory'] = '.'
gitlab_rails['backup_keep_time'] = 604800

backup_upload_remote_directory 1\ backup_keep_time 2\ manage_backup_path 3\ gitlab_default_projects_features_builds 4

Info and References​

  1. Sub-directory local_root or use . for root.↩
  2. Limit backup lifetime to 7 days - 604800 seconds.↩
  3. When modifying backup_path, set manage_backup_path configuration to false.↩
  4. Disable CI/CD site-wide.↩