Setup up work Gitlab server

Post tags: | debian | git | gitlab | linux |

Gitlab Omnibus Readme

Configuration options

Configuration done in file:

  • /etc/gitlab/gitlab.rb
sudo gitlab-ctl reconfigure

GitLab and GitLab CI are configured by setting their relevant options in /etc/gitlab/gitlab.rb. For a complete list of available options, visit the gitlab.rb.template. New installations starting from GitLab 7.6, will have all the options of the template listed in /etc/gitlab/gitlab.rb by default.

SMTP settings

If you would rather send application email via an SMTP server instead of via Sendmail, add the following configuration information to /etc/gitlab/gitlab.rb and run gitlab-ctl reconfigure.

in /etc/gitlab/gitlab.rb
        gitlab_rails['smtp_enable'] = true
        gitlab_rails['smtp_address'] = "smtp.server"
        gitlab_rails['smtp_port'] = 456
        gitlab_rails['smtp_user_name'] = "smtp user"
        gitlab_rails['smtp_password'] = "smtp password"
        gitlab_rails['smtp_domain'] = ""
        gitlab_rails['smtp_authentication'] = "login"
        gitlab_rails['smtp_enable_starttls_auto'] = true

If your SMTP server does not like the default ‘From: gitlab@localhost’ you can change the ‘From’ with this setting.

in /etc/gitlab/gitlab.rb
        gitlab_rails['gitlab_email_from'] = ''

To change GitLab CI email configuration (e.g. use SMTP), use gitlab_ci instead of gitlab_rails.

in /etc/gitlab/gitlab.rb
        gitlab_ci['gitlab_ci_email_from'] = ''
        gitlab_ci['smtp_enable'] = true
        gitlab_ci['smtp_address'] = "smtp.server"

GitLab Community Edition Omnibus package for Debian 7

The current “stable” distribution of Debian is version 7, codenamed wheezy. It was initially released as version 7.0 on May 4th, 2013 and its latest update, version 7.7, was released on October 18th, 2014.

Base install


        Software Selection
        remove Debian desktop environment
        leave Print server
        Add SSH server
        remove laptop

        apt-get update
        apt-get dist-upgrade
        apt-get install vim
        apt-get install tmux
        apt-get install git
        apt-get install sudo
        adduser craig sudo
        git config --global "Your Name Here"
         Sets the default name for git to use when you commit
        git config --global ""
         Sets the default email for git to use when you commit

        ssh-copy-id -i ~/.ssh/ $host

Gitlab install / Setup

From Debian 7 selection

        sudo apt-get install openssh-server
        sudo apt-get install postfix # Select 'Internet Site', using sendmail instead also works, exim has problems
        Suggested packages:
          postfix-mysql postfix-pgsql postfix-ldap postfix-pcre sasl2-bin dovecot-common resolvconf postfix-cdb ufw postfix-doc
        The following packages will be REMOVED:
          exim4 exim4-base exim4-config exim4-daemon-light
        The following NEW packages will be installed:
         Internet site:                                                                                                               
          │   Mail is sent and received directly using SMTP. 
        System mail name:                                                                                                                                                 │     
            │                                                                                                                                                                   │     
        sudo dpkg -i
        Setting up gitlab ( ...
        Thank you for installing GitLab!
        Configure and start GitLab by running the following command:
        sudo gitlab-ctl reconfigure
        GitLab should be reachable at
        Otherwise configure GitLab for your system by editing /etc/gitlab/gitlab.rb file
        And running reconfigure again.
        gitlab-ctl reconfigure

reconfigure failed the first time. Edit /etc/gitlab/gitlab.rb Also, set the email from.

diff /etc/gitlab/gitlab.rb.1 /etc/gitlab/gitlab.rb
        < external_url ''
        > external_url ''
        > gitlab_rails['gitlab_email_from'] = ''

        < external_url ''
        > external_url ''

Browse to the hostname and login

        Username: root
        Password: 5iveL!fe 

Change password.

smtp access to

  • server name:
  • port: 26
  • user name:
  • Authentication method: Normal password
  • Connection Security: STARTTLS

postfix configuration

Need to configure postfix

$ hostname --fqdn
$ postconf -n
        alias_database = hash:/etc/aliases
        alias_maps = hash:/etc/aliases
        append_dot_mydomain = no
        biff = no
        config_directory = /etc/postfix
        inet_interfaces = all
        mailbox_command = procmail -a "$EXTENSION"
        mailbox_size_limit = 0
        mydestination =,, , localhost
        myhostname =
        mynetworks = [::ffff:]/104 [::1]/128
        myorigin = /etc/mailname
        readme_directory = no
        recipient_delimiter = +
        relayhost =
        smtp_tls_session_cache_database = btree:${data_directory}/smtp_scache
        smtpd_banner = $myhostname ESMTP $mail_name (Debian/GNU)
        smtpd_tls_cert_file = /etc/ssl/certs/ssl-cert-snakeoil.pem
        smtpd_tls_key_file = /etc/ssl/private/ssl-cert-snakeoil.key
        smtpd_tls_session_cache_database = btree:${data_directory}/smtpd_scache
        smtpd_use_tls = yes

Postfix on a null client

A null client is a machine that can only send mail. It receives no mail from the network, and it does not deliver any mail locally. A null client typically uses POP, IMAP or NFS for mailbox access.

  1. /etc/postfix/
  2. myhostname =
  3. myorigin = $mydomain
  4. relayhost = $mydomain
  5. inet_interfaces = loopback-only
  6. mydestination =


  • Line 2: Set myhostname to, in case the machine name isn’t set to a fully-qualified domain name (use the command “postconf -d myhostname” to find out what the machine name is).
  • Line 2: The myhostname value also provides the default value for the mydomain parameter (here, “mydomain =”).
  • Line 3: Send mail as “” (instead of “”), so that nothing ever has a reason to send mail to “”.
  • Line 4: Forward all mail to the mail server that is responsible for the “” domain. This prevents mail from getting stuck on the null client if it is turned off while some remote destination is unreachable. Specify a real hostname here if your “” domain has no MX record.
  • Line 5: Do not accept mail from the network.
  • Line 6: Disable local mail delivery. All mail goes to the mail server as specified in line 4.

  • Linode - Configure Postfix to Send Mail Using an External SMTP Server
Edit /etc/postfix/
        /etc/postfix# diff
        < myorigin = /etc/mailname
        < mydestination =,, , localhost
        < relayhost = 
        > myorigin = $mydomain
        > mydestination =
        > relayhost = []:26
        < inet_interfaces = all
        > inet_interfaces = loopback-only
        > # see -
        > # enable SASL authentication 
        > smtp_sasl_auth_enable = yes
        > # disallow methods that allow anonymous authentication. 
        > smtp_sasl_security_options = noanonymous
        > # where to find sasl_passwd
        > smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
        > # Enable STARTTLS encryption 
        > smtp_use_tls = yes
        > # where to find CA certificates
        > smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt
Configuring SMTP Usernames and Passwords
Create the hash db file for Postfix by running the postmap command:
postmap /etc/postfix/sasl_passwd

If all went well, you should have a new file named sasl_passwd.db in the /etc/postfix/ directory.

Securing Your Password and Hash Database Files

The /etc/postfix/sasl_passwd and the /etc/postfix/sasl_passwd.db files created in the previous steps contain your SMTP credentials in plain text.

For security reasons, you should change their permissions so that only the root user can read or write to the file. Run the following commands to change the ownership to root and update the permissions for the two files:

Change permissions of sasl_passwd and sasl_passwd.db
        chown root:root /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db
        chmod 0600 /etc/postfix/sasl_passwd /etc/postfix/sasl_passwd.db
echo "body of your email" | mail -s "This is a Subject" -a "From:"
        git remote set-url origin

postfix research

Install Gitlab virtualbox guest on vmhost

Unpack and initial setup

dhcp ip:

Pick a static IP

DNS for Gitlab



bitnami Review - 10/18/2014 - Easy to install and configure - By Nacho Sanchez

Installation takes 5 minutes, and configuration is very easy since they include links to FAQs and basic stuff you should know.

Configuring the email can get tricky, so here is the basic stuff:

Be careful with the host and port, since it sets the ones where the machine installs by default, but if you then assign a static IP you must change them manually.