Install GitLab on CentOS 7
Last updated on: 2020-07-30
Authored by: Rackspace Support
GitLab® Community Edition, or GitLab CE, is an open-source web-based Git repository featuring a wiki and issue tracking. This article describes how to install GitLab CE and configure Secure Sockets Layer (SSL) on a CentOS® 7 Cloud Server.
- A CentOS 7 server with at least 8 GB of RAM
- A domain name pointed at your server
There are a few dependencies that you must install before you install GitLab.
CentOS 7 installs most, if not all, of these packages by default, but you
should ensure that they are installed before you try to install GitLab.
Install the packages with
yum by using the following command:
sudo yum install -y curl policycoreutils-python openssh-server postfix
During the postfix installation, select Internet Site. On the next page, enter your domain name. Then, start and enable Postfix:
sudo systemctl enable postfix && sudo systemctl start postfix
Install GitLab CE
After you finish installing the dependencies, perform the following steps:
Change directory to /tmp:
Run the repository script from gitlab.com:
Install the repository:
sudo bash script.rpm.sh
Then, install GitLab CE:
sudo yum install gitlab-ce
After you enter the command to install GitLab CE, you should see a warning about setting your domain name. While
fixing that, go ahead and enable SSL with
letsencrypt. Perform the following steps:
Open the GitLab configuration file with a text editor. This example uses
sudo nano /etc/gitlab/gitlab.rb
external_url fieldand update it to match your domain name, changing
HTTPS. It should look similar to the following example:
Look for the
letsencrypt[‘contact_emails’]field. If there is ever a problem with your SSL certificate, the system alerts the email addresses listed in this field. It should look similar to the following example:
letsencrypt['contact_emails'] = ['email@example.com']
Save the file and exit.
Reconfigure GitLab to have it read the new configuration file. This part may take a few minutes.
sudo gitlab-ctl reconfigure
After the reconfiguration finishes, navigate to your domain name in your web browser to start using GitLab CE.